Fix `dyld[]: missing symbol called` errors when running Node.js programs on M1 Macs (apple silicon)

fix-dyld-missing-symbol-called-errors-on-m1-macs.md

Problem

If you're getting this kind of error when running Node.js programs with binary dependencies that don't support M1 yet, e.g.:

$ yarn test
dyld[51175]: missing symbol called
dyld[51176]: missing symbol called

Solution

tl;dr: (Re)install a x64 build of Node.js.

Steps to follow

1. Start a new shell using Rosetta2

   $ arch -x86_64 zsh

2. In that shell, reinstall the x64 version of Node.js

   $ nvm use system
   $ nvm cache clear
   $ nvm uninstall 16 # or the version you need
   $ nvm install 16   # or the version you need
   $ nvm use 16       # or the version you need

3. Still in that shell, reinstall and build npm dependencies from scratch

   $ rm -rf node_modules
   $ yarn cache clean
   $ yarn install

4. Whenever you come back to your project (e.g. after restarting), don't forget to select that same version of Node.js!

   $ nvm use 16 # or the one you installed in step 2

Troubleshooting

If you still see the error:

• Try (re)installing your dependencies with npm install instead of yarn install.

• It could be that the node command is not linked to nvm.

  • To check that, run nvm use 16; nvm ls and check that the little arrow (->) targets v16.
  • If it targets system, you may want to uninstall any other installation of node (e.g. which node; brew uninstall node), then retry the whole procedure.

i'm not using NVM and didn't feel like messing with my node installation. i realized i was trying to deploy my code from the terminal inside vscode. when i opened a new mac terminal outside of vscode with settings "open with rosetta in get info" then it worked. something to do with "fast-crc32c" unable to link without x64.

EDIT: a little over a year later I had this issue again on a new M1 primarily running arm. I am using the "n" version manager so the command i needed was "n --arch x64 <whatever_version_you_want>" in a rosetta terminal.

I don't know why, but after going through the steps, deleting node_modules and package-lock.json, using yarn instead of npm worked for me

@nescroft I had the same issue with fast-crc32c, thank you :)

this is not allways true, as the error missing symbol called can also mean that you just missing a .cpp file in your binding.gyp so that a symbol is defined but not implemented or initialized.

To make sure your issue is not because of the processor infrastructure (arm / intel and so on) just try your code on an x64 plattform
if the error persists then you may have truly a symbol which is just missing by the linker or by calling.

hi this doesnt work. i already followed the steps that you explain. any tips?

Hey were you able to solve this issue? i am facing the same issue

@thisisarjuns i see an error message right before the missing symbol called in your screenshot mentioning something about sequelize deprecated. maybe you need to solve this first.

the missing symbol called simply means that your linker can not resolve a symbol within a native library
that means something is not declared properly. So as mentioned, check if you have included all needed sourcefiles in your binding.gyp
in my case i was missing a .cpp file within it.

c++ specific:
if you thinking that there is nothing missing, check within the code of the native library if
you have declared all of your static variables within your implementation file
you need to have them not only defined in the header but also declared in the .cpp file

general feedback:
i did a project using mac making a c++ native library and used it with nodejs via npm and included it with require in my js file.
i got this error too and stumbled upon lots of suggestions this should be a architecture issue with arm64. But my experience shows even with an M1 i use here it works fine! you just have a worse error message not telling what is missing. So you need to review your native code carefully. in best make a question on stackoverflow and let a different user look on your code to maybe find the issue.

which is the same i did here: https://stackoverflow.com/questions/73580576/dyld49745-missing-symbol-called-using-c-swig-with-node-js-by-calling-a-funct

@RolfHausen - you are right, was an issue with the deprecated feature in sequelize, i have upgraded the node version and it solved the issue 🙂

Just a comment: for me the solution wasn't working when using MacOS Monterey, but after upgrading to MacOS Ventura it worked. But again, I had to follow all steps.

Noicceeeee worked for me as well, Thanks for all the steps.

@adrienjoly 's solution works for me.

Another option is to use fnm (install using brew install fnm), and then use fnm --arch x64 install 16

@adrienjoly works perfectly for me even for node 18.

I am getting this problem while working on rust code.

Works perfectly ❤️ even for node 18

I am getting this problem when run with node 18.18.2 Mac M1 chip . Anyone could help to resolve this issue?
dyld[68363]: missing symbol called

Works perfectly for node 14.21.3 on Mac M2 chip

Worked well for node 16 on M2!

"firebase-store" started to work as expected in my project, without "dyld[...]: missing symbol called" crash :)

M2 chip here:

For those using @google-cloud/storage (or firebase-admin storage module), it optionally uses fast-crc32c which is not compatible with ARM, hence the dyld[...]: missing symbol called. ([email protected] at the time of writing).

Performance is a concern for us, and we weren't sure whether it was worse to slow down CRC calculation or to slow down all the rest by running unnecessarily under Rosetta.

We decided to get rid of fast-crc32c and keep running under ARM. But we haven't really benchmarked yet to make sure it was actually convenient. If anyone has, please advice.

EDIT:
That above all happened while we were running under Node 16.
We just migrated to Node 20 and decided to try again using [email protected] and it did work under ARM without Rosetta.
It didn't under Node 16 🤷‍♀️ Oh, well...

not work 😢

(base) ➜  server git:(main) ✗ bun ./src/index.ts
dyld[25666]: missing symbol called
[1]    25666 killed     bun ./src/index.ts
(base) ➜  server git:(main) ✗ arch -x86_64 zsh
(base) ➜  server git:(main) ✗ nvm use system
Now using system version of node: v21.6.0 (npm v10.2.4)
(base) ➜  server git:(main) ✗ nvm cache clear
nvm cache cleared.
(base) ➜  server git:(main) ✗ nvm uninstall v21.6.0
N/A version is not installed...
(base) ➜  server git:(main) ✗ nvm install v21.6.0 
Downloading and installing node v21.6.0...
Downloading https://nodejs.org/dist/v21.6.0/node-v21.6.0-darwin-x64.tar.xz...
################################################################################ 100.0%
Computing checksum with shasum -a 256
Checksums matched!
Now using node v21.6.0 (npm v10.2.4)
(base) ➜  server git:(main) ✗ nvm use v21.6.0     
Now using node v21.6.0 (npm v10.2.4)
(base) ➜  server git:(main) ✗ rm -rf node_modules    
(base) ➜  server git:(main) ✗ bun i       
[0.25ms] ".env.local"
bun install v1.0.24 (6fa35839)

 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + @types/[email protected]
 + [email protected]
 + [email protected]
 + @supabase/[email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]
 + [email protected]

warn: canvas's install script took 5m11.2s

 241 packages installed [312.43s]
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ 
(base) ➜  server git:(main) ✗ bun ./src/index.ts   
1 | 'use strict'
2 | 
3 | const bindings = require('../build/Release/canvas.node')
          ^
TypeError: dlopen(/Users/stepbystep/Documents/typing-app/server/node_modules/canvas/build/Release/canvas.node, 0x0001): tried: '/Users/stepbystep/Documents/typing-app/server/node_modules/canvas/build/Release/canvas.node' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64')), '/System/Volumes/Preboot/Cryptexes/OS/Users/stepbystep/Documents/typing-app/server/node_modules/canvas/build/Release/canvas.node' (no such file), '/Users/stepbystep/Documents/typing-app/server/node_modules/canvas/build/Release/canvas.node' (mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64'))
      at /Users/stepbystep/Documents/typing-app/server/node_modules/canvas/lib/bindings.js:3:7
      at /Users/stepbystep/Documents/typing-app/server/node_modules/canvas/lib/canvas.js:9:7
      at /Users/stepbystep/Documents/typing-app/server/node_modules/canvas/index.js:1:7
(base) ➜  server git:(main) ✗ 

niubi

good it's work for me