Addon fails to load on Ubuntu 22.04 due to musl-linked binary (libc.musl-x86_64.so.1 not found)

[Dr-klo]

Describe the bug

The ZeroMQ.js native addon fails to load on Ubuntu 22.04 with Node.js 18.20.7.
It tries to load a prebuilt binary linked against musl (libc.musl-x86_64.so.1), which is unavailable on glibc-based systems like Ubuntu.

Reproducing

Steps to reproduce:

1. On Ubuntu 22.04 with Node.js 18.20.7:
2. Install zeromq v6.4.0 via npm install zeromq
3. Run a Node.js project with a simple import of zeromq
4. The following error appears:

Failed to load addon at /root/myproject/node_modules/zeromq/build/linux/x64/node/127/addon.node: 
Error: libc.musl-x86_64.so.1: cannot open shared object file: No such file or directory

I attempted a workaround by installing musl and symlinking:

apt install musl-dev
ln -s /usr/lib/x86_64-linux-musl/libc.so /lib/libc.musl-x86_64.so.1

This leads to a different error:

Error: addon.node: undefined symbol: __cxa_call_terminate

Expected behavior

ZeroMQ.js should either:

• Provide a prebuilt binary linked against glibc for Linux,
• Or fall back to source build during npm install if no compatible binary is found.

Tested on

• OS: Ubuntu 22.04
• Node.js: 18.20.7
• ZeroMQ.js version: 6.4.0

[aminya]

It should continue to load other glibc binaries, but it seems the error for loading the musl binary is fatal breaking the node process.

Does it work with the previous version?

[SchahinRohani]

I can reproduce this on WSL2 with Ubuntu 24.04 and Node v22.11.0.

It works with zeromq 6.3.0 though.

[aminya]

Merged some changes to this in 6.4.1. Could you test?

[ashkalor]

@aminya still breaking, 6.4.1 works with ubuntu 20.04 but fails with ubuntu 22.04
I can confirm that v6.3.0 works on ubuntu 22.04 without any issues.
Also since I was the one the who raised the #710. It still doesn't load prebuilt binary but instead builds from source all the time.

These are the logs for Ubuntu 22.04 when trying to install v6.4.1

node_modules/.pnpm/zeromq@6.4.1/node_modules/zeromq: Running install script, failed in 1.6s
.../zeromq@6.4.1/node_modules/zeromq install$ node ./script/install.js
│ Error: Failed to load zeromq.js addon.node: Error: No compatible zeromq.js addon found for linux arm64 glibc. The c…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null,…
│ {"name":"","dev":false,"os":"win32","arch":"x64","runtime":"node","runtimeVersion":"20.18.3","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"win32","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null,…
│ {"name":"","dev":false,"os":"win32","arch":"ia32","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,…
│ {"name":"windows-x86","os":"win32","arch":"ia32","runtime":"node","runtimeVersion":"12.22.12","additionalDefines":[…
│ {"name":"","dev":false,"os":"darwin","arch":"x64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,…
│ {"name":"","dev":false,"os":"darwin","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null…
│ {"name":"","dev":false,"os":"darwin","arch":"arm64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":nul…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"arm64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null…
│ Error: No compatible zeromq.js addon found for linux arm64 glibc. The candidates were:
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null,…
│ {"name":"","dev":false,"os":"win32","arch":"x64","runtime":"node","runtimeVersion":"20.18.3","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"win32","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null,…
│ {"name":"","dev":false,"os":"win32","arch":"ia32","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,…
│ {"name":"windows-x86","os":"win32","arch":"ia32","runtime":"node","runtimeVersion":"12.22.12","additionalDefines":[…
│ {"name":"","dev":false,"os":"darwin","arch":"x64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":null,…
│ {"name":"","dev":false,"os":"darwin","arch":"x64","runtime":"node","runtimeVersion":"12.22.12","toolchainFile":null…
│ {"name":"","dev":false,"os":"darwin","arch":"arm64","runtime":"node","runtimeVersion":"20.19.0","toolchainFile":nul…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"x64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null,"…
│ {"name":"","dev":false,"os":"linux","arch":"arm64","runtime":"node","runtimeVersion":"22.14.0","toolchainFile":null…
│     at findAddon (/home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules…
│     at Object.<anonymous> (/home/test/node_modules/.pnpm/zeromq@6.4.1/nod…
│     at Module._compile (node:internal/modules/cjs/loader:1554:14)
│     at Object..js (node:internal/modules/cjs/loader:1706:10)
│     at Module.load (node:internal/modules/cjs/loader:1289:32)
│     at Function._load (node:internal/modules/cjs/loader:1108:12)
│     at TracingChannel.traceSync (node:diagnostics_channel:322:14)
│     at wrapModuleLoad (node:internal/modules/cjs/loader:220:24)
│     at Module.require (node:internal/modules/cjs/loader:1311:12)
│     at require (node:internal/modules/helpers:136:16)
│     at findAddon (/home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules…
│     at Object.<anonymous> (/home/test/node_modules/.pnpm/zeromq@6.4.1/nod…
│     at Module._compile (node:internal/modules/cjs/loader:1554:14)
│     at Object..js (node:internal/modules/cjs/loader:1706:10)
│     at Module.load (node:internal/modules/cjs/loader:1289:32)
│     at Function._load (node:internal/modules/cjs/loader:1108:12)
│     at TracingChannel.traceSync (node:diagnostics_channel:322:14)
│     at wrapModuleLoad (node:internal/modules/cjs/loader:220:24)
│     at Module.require (node:internal/modules/cjs/loader:1311:12)
│     at require (node:internal/modules/helpers:136:16)
│ Building addon node via cmake-ts (requires cmake, ninja, and the vcpkg dependencies)
│ --------------------------------------------------
│       WARNING: Building only for the current runtime.
│       WARNING: DO NOT SHIP THE RESULTING PACKAGE
│      --------------------------------------------------
│ 'os' was missing in the 'configurations'. Defaulting to the current operating system linux
│ 'arch' was missing in the 'configurations'. Defaulting to the current architecture arm64
│ `runtime` was missing in the `configurations`. Defaulting to `node`
│ 'runtimeVersion' was missing in the 'configurations'. Defaulting to the current runtimeVersion 22.14.0
│ no generator specified in package.json, checking ninja
│ found ninja at /usr/bin/ninja
│ running in /home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/zeromq…
│ > Setting up staging directory... [ DONE ]
│ ---------------- BEGIN CONFIG ----------------
│ > Distribution File Download... [ DONE ]
│ > Determining ABI... [ DONE ]
│ > Building directories... [ DONE ]
│ > Applying overrides... [ DONE, 0 applied ]
│ --------------- CONFIG SUMMARY ---------------
│ Name:  N/A
│ OS/Arch: linux arm64
│ Runtime: node 22.14.0
│ Target ABI: 127
│ Toolchain File: null
│ Custom CMake options: no
│ Staging area: /home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/zer…
│ Target directory: /home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules…
│ Build Type Release
│ ----------------------------------------------
│ > Setting up config specific staging directory... [ DONE ]
│ > Building CMake command line... "/usr/bin/cmake" "/home/test/node_module…
│ [ DONE ]
│ > Invoking CMake... Not searching for unused variables given on the command line.
│ -- ZMQ_DRAFT: ON
│ -- ZMQ_CURVE: ON
│ -- ZMQ_SODIUM: ON
│ -- ZMQ_WEBSOCKETS: OFF
│ -- ZMQ_WEBSOCKETS_SECURE: OFF
│ -- ZMQ_NO_SYNC_RESOLVE: OFF
│ -- ZMQ_ENABLE_SANITIZER_UNDEFINED: OFF
│ -- Repository already exists at /home/test/vcpkg.
│ -- Skipping vcpkg update as it's already at 608d1dbcd6969679f82b1ca6b89d58939c9b228e
│ -- Running vcpkg install
│ error: /usr/bin/git --git-dir /home/test/vcpkg/.git -c core.autocrlf=false --work-tree /home/test/vcpkg/buildtree…
│ error: unknown option `ignore-skip-worktree-bits'
│ usage: git checkout-index [<options>] [--] [<file>...]
│     -a, --all             check out all files in the index
│     -f, --force           force overwrite of existing files
│     -q, --quiet           no warning for existing files and files not in index
│     -n, --no-create       don't checkout new files
│     -u, --index           update stat information in the index file
│     -z                    paths are separated with NUL character
│     --stdin               read list of paths from the standard input
│     --temp                write the content to temporary files
│     --prefix <string>     when creating files, prepend <string>
│     --stage (1|2|3|all)   copy out the files from named stage
│ note: while checking out port zeromq with git tree 454f5e2648cea10a305d0e781fd3093073153a2e
│ note: See https://learn.microsoft.com/vcpkg/users/versioning-troubleshooting?WT.mc_id=vcpkg_inproduct_cli for more …
│ note: while loading zeromq@4.3.5#2
│ -- Running vcpkg install - failed
│ CMake Error at /home/test/vcpkg/scripts/buildsystems/vcpkg.cmake:938 (message):
│   vcpkg install failed.  See logs for more information:
│   /home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/zeromq/staging/…
│ Call Stack (most recent call first):
│   /usr/share/cmake-3.22/Modules/CMakeDetermineSystem.cmake:124 (include)
│   CMakeLists.txt:115 (project)
│ CMake Error: CMake was unable to find a build program corresponding to "Ninja".  CMAKE_MAKE_PROGRAM is not set.  Yo…
│ CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
│ CMake Error: CMAKE_CXX_COMPILER not set, after EnableLanguage
│ -- Configuring incomplete, errors occurred!
│ Generic error occured Error: Process terminated: 1
│     at ChildProcess.<anonymous> (/home/test/node_modules/.pnpm/cmake-ts@0…
│     at ChildProcess.emit (node:events:518:28)
│     at ChildProcess._handle.onexit (node:internal/child_process:293:12)
│ node:child_process:921
│     throw err;
│     ^
│ Error: Command failed: /home/test/.local/share/fnm/node-versions/v22.14.0/installation/bin/node /home/test/test-…
│     at genericNodeError (node:internal/errors:983:15)
│     at wrappedFn (node:internal/errors:537:14)
│     at checkExecSyncError (node:child_process:882:11)
│     at Object.execFileSync (node:child_process:918:15)
│     at cmakeTs (/home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/z…
│     at main (/home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/zero…
│     at Object.<anonymous> (/home/test/node_modules/.pnpm/zeromq@6.4.1/nod…
│     at Module._compile (node:internal/modules/cjs/loader:1554:14)
│     at Object..js (node:internal/modules/cjs/loader:1706:10)
│     at Module.load (node:internal/modules/cjs/loader:1289:32) {
│   status: 1,
│   signal: null,
│   output: [ null, null, null ],
│   pid: 4007,
│   stdout: null,
│   stderr: null
│ }
│ Node.js v22.14.0
└─ Failed in 1.6s at /home/test/node_modules/.pnpm/zeromq@6.4.1/node_modules/zeromq
 ELIFECYCLE  Command failed with exit code 1.

[aminya]

Unfortunately, Linux arm64 binaries were missing in the previous release. The build happened on x64, although I specified aarch64 as the platform.
https://github.com/zeromq/zeromq.js/actions/runs/14183430277/job/39734260804#step:17:262

I am replacing the action with a Docker solution in #719