CurlMultiError: Could not remove easy handle from multi handle.: API function called from within callback

[naicoi92]

Describe the bug

2025-12-10T09:42:23.558510125Z file:///app/index.js:1680
2025-12-10T09:42:23.558532087Z multi.removeHandle(this.handle);
2025-12-10T09:42:23.558535075Z ^
2025-12-10T09:42:23.558537184Z
2025-12-10T09:42:23.558540401Z CurlMultiError: Could not remove easy handle from multi handle.: API function called from within callback
2025-12-10T09:42:23.558543062Z at file:///app/index.js:1680:15 {
2025-12-10T09:42:23.558545229Z code: 8
2025-12-10T09:42:23.558547484Z }
2025-12-10T09:42:23.558549644Z
2025-12-10T09:42:23.558551746Z Node.js v22.21.1

To Reproduce

Steps to reproduce the behavior, if possible, provide a Dockerfile that is able to reproduce the issue.

Version information:

Version: v5.0.1

Version: libcurl/8.17.0 OpenSSL/3.5.4 zlib/1.3.1 brotli/1.1.0 zstd/1.5.7 libidn2/2.1.1 libssh2/1.10.0 nghttp2/1.64.0 ngtcp2/1.17.0 nghttp3/1.12.0 OpenLDAP/2.6.9
Protocols: dict, file, ftp, ftps, gopher, gophers, http, https, imap, imaps, ldap, ldaps, mqtt, pop3, pop3s, rtsp, scp, sftp, smb, smbs, smtp, smtps, telnet, tftp, ws, wss
Features: AsynchDNS, IDN, IPv6, Largefile, NTLM, SSL, libz, brotli, TLS-SRP, HTTP2, UnixSockets, HTTPS-proxy, alt-svc

OS:
Node.js Version: v22.12.1

Additional context
Build and run on: FROM node:22-alpine3.22

[xeleniumz]

I found the same problem with you in node alphine image just change docker image to node lts , your problem should be solve

[xeleniumz]

after recheck and test I was downgrade image to alphine 22 then use node libcurl version ^4.11 and it's work as expect.

[JCMais]

Is there a specific code that reproduces this on Alpine? I am not being able to reproduce it myself

[xeleniumz]

here is my example code from nestjs

import { Injectable, Logger, HttpException, HttpStatus } from '@nestjs/common';
import { Curl } from 'node-libcurl';
import * as path from 'path';
import * as qs from 'qs';
import * as fs from 'fs';

import { HttpMethod } from 'src/enums/http.enum';

export interface CurlResponse {
  statusCode: number;
  body: string;
  headers: Record<string, any>;
}
export type HeadersType = 'xml' | 'json' | 'crawler' | 'formData' | undefined;

type CurlConfig = {
  url: string;
  headers: string[];
  debug: boolean;
};

@Injectable()
export class CurlHttpService {
  private readonly logger = new Logger(CurlHttpService.name);
  private cookieFilePath: string;
  public curlConfig: CurlConfig = {
    url: '',
    headers: [],
    debug: false,
  };

  constructor() {}

  public setFilePath(username: string, type: 'cookie'): void {
    const fileName = `${type}-${username}.${type === 'cookie' ? 'txt' : 'gif'}`;
    const filePath = path.join(process.cwd(), 'data', type, fileName);
    this.cookieFilePath = filePath;
  }

  public setCurlHeaders(type?: HeadersType): string[] {
    const headers = {
      xml: ['Accept: application/xml', 'Content-Type: application/xml'],
      json: ['Accept: application/json', 'Content-Type: application/json'],
      crawler: [
        'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
        'Cache-Control: max-age=0',
        'Connection: keep-alive',
        `cache-control: max-age=0`,
        `sec-fetch-mode: navigate`,
        `sec-fetch-site: none`,
        `sec-fetch-user: ?1`,
        // `Referer: ${cache.host}`,
        `upgrade-insecure-requests: 1`,
        'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36 Edg/139.0.0.0',
      ],
      formData: [
        'Content-Type: application/x-www-form-urlencoded',
        'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8',
        'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
      ],
      default: [
        'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8',
        'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
      ],
    };

    return headers[type || 'default'];
  }

  async makeRequest(
    operationName: string,
    method: HttpMethod,
    url: string,
    payload?: unknown,
    headersType?: HeadersType,
  ): Promise<CurlResponse> {
    return new Promise((resolve, reject) => {
      this.logger.log(operationName, `Making ${method} request to ${url}`);

      const curl = new Curl();
      const fullUrl = `${this.curlConfig.url}${url}`;
      const requestHeaders = this.setCurlHeaders(headersType);

      this.setCurlOptions(curl, method, fullUrl, payload, requestHeaders);

      curl.on('end', (statusCode, data, curlHeaders) => {
        curl.close();
        const responseData = Buffer.isBuffer(data) ? data.toString() : data;
        resolve({ statusCode, body: responseData, headers: curlHeaders });
      });

      curl.on('error', (error) => {
        curl.close();
        this.logger.error('CURL request error', error);
        reject(
          new HttpException(error.message, HttpStatus.INTERNAL_SERVER_ERROR),
        );
      });

      curl.perform();
    });
  }

  private setCurlOptions(
    curl: Curl,
    method: HttpMethod,
    url: string,
    payload: unknown,
    headers?: string[],
  ): void {
    curl.setOpt(Curl.option.URL, url);
    curl.setOpt(Curl.option.TIMEOUT, 30);
    curl.setOpt(Curl.option.SSL_VERIFYHOST, 0);
    curl.setOpt(Curl.option.SSL_VERIFYPEER, 0);
    if (headers) {
      // HTTPHEADER is a StringListOptions type that accepts string[]
      curl.setOpt(Curl.option.HTTPHEADER as 'HTTPHEADER', headers);
    }
    curl.setOpt(Curl.option.VERBOSE, this.curlConfig.debug);
    curl.setOpt(Curl.option.FOLLOWLOCATION, true);
    curl.setOpt(Curl.option.COOKIEFILE, this.cookieFilePath);
    curl.setOpt(Curl.option.COOKIEJAR, this.cookieFilePath);
    if (method !== HttpMethod.GET && payload) {
      curl.setOpt(Curl.option.CUSTOMREQUEST, method);
      let postData: string;
      if (
        typeof payload === 'object' &&
        payload !== null &&
        !Array.isArray(payload)
      ) {
        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
        postData = qs.stringify(payload as Record<string, unknown>);
      } else if (typeof payload === 'string') {
        postData = payload;
      } else {
        postData = JSON.stringify(payload);
      }
      curl.setOpt(Curl.option.POSTFIELDS, postData);
    }
  }
}

and when I use it in service

import { Injectable, Logger } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

import { CurlHttpService } from 'src/curl-http/curl-http.service';
import { HttpMethod } from 'src/enums/http.enum';
import { UtilityService } from 'src/utility/utility.service';
@Injectable()
export class PosService {
  private readonly logger = new Logger(PosService.name);
  private readonly baseUrl: string = '';
  private readonly username: string = '';
  private readonly password: string = '';
  private readonly pincode: string = '';

  constructor(
    private readonly configService: ConfigService,
    private readonly utilityService: UtilityService,
    private readonly curlHttpService: CurlHttpService,
  ) {
    this.baseUrl = this.configService.getOrThrow('POS_URL');
    this.username = this.configService.getOrThrow('POS_USERNAME');
    this.curlHttpService.setFilePath(this.username, 'cookie');
  }


  async getBills() {
    try {
      const { body } = await this.curlHttpService.makeRequest(
        'getBills',
        HttpMethod.GET,
        `${this.baseUrl}/bill-management.php?page=1`,
        undefined,
        'crawler',
      );
      return this.utilityService.convertBillsTableToJson(body);
    } catch (error) {
      this.logger.error('Error getting bills', error);
      throw error;
    }
  }

}

I tested with cron job by call get bills method every minute in docker and found this error.
thank you for your support