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

Last active October 17, 2024 07:18

Star () You must be signed in to star a gist
Fork () You must be signed in to fork a gist

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/adrienjoly/e29a6e73fb7e701eefd80ff9bde9abeb.js"></script>
Save adrienjoly/e29a6e73fb7e701eefd80ff9bde9abeb to your computer and use it in GitHub Desktop.

Download ZIP

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

Raw

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

Start a new shell using Rosetta2
```
$ arch -x86_64 zsh
```

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

Still in that shell, reinstall and build npm dependencies from scratch
```
$ rm -rf node_modules
$ yarn cache clean
$ yarn install
```
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.

aridder commented Mar 27, 2022

Thank you. Helped a lot

Author

adrienjoly commented Mar 27, 2022 •

edited

Loading

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

Does the same program work on a x64 (i.e. non-M1) machine, @galihcitta?

If not, although the error message is the same, this solution may be useless in your case. Example of another problem causing a similar error message: https://discourse.julialang.org/t/how-can-i-configure-pkg-to-use-specific-git/71420.

Good luck! 💪

nescroft commented Aug 2, 2022 •

edited

Loading

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.

benjifriedman commented Aug 6, 2022

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

tgensol commented Aug 7, 2022

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

RolfHausen commented Sep 19, 2022

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.

thisisarjuns commented Oct 5, 2022

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

RolfHausen commented Oct 5, 2022

@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

thisisarjuns commented Oct 5, 2022

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

caiobozato commented Oct 27, 2022

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.

pushpanktugnawat commented Dec 30, 2022

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

ramu-actyv commented Mar 1, 2023

@adrienjoly 's solution works for me.

nkiesel commented Mar 8, 2023

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

danielkochengineer commented Aug 28, 2023

@adrienjoly works perfectly for me even for node 18.

suryapandian commented Sep 15, 2023

I am getting this problem while working on rust code.

Ahmadre commented Oct 11, 2023

Works perfectly ❤️ even for node 18

selvarajshanmugam commented Nov 2, 2023 •

edited

Loading

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

windowye commented Nov 13, 2023

Works perfectly for node 14.21.3 on Mac M2 chip

IPv6 commented Dec 5, 2023

Worked well for node 16 on M2!

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

maganap commented Jan 25, 2024 •

edited

Loading

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...

stepbystepcode commented Feb 1, 2024

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) ✗

yuannight commented Jun 5, 2024

niubi

houskii commented Jul 25, 2024

good it's work for me

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

Problem

Solution

Steps to follow

Troubleshooting

aridder commented Mar 27, 2022

adrienjoly commented Mar 27, 2022 • edited Loading

nescroft commented Aug 2, 2022 • edited Loading

benjifriedman commented Aug 6, 2022

tgensol commented Aug 7, 2022

RolfHausen commented Sep 19, 2022

thisisarjuns commented Oct 5, 2022

RolfHausen commented Oct 5, 2022

thisisarjuns commented Oct 5, 2022

caiobozato commented Oct 27, 2022

pushpanktugnawat commented Dec 30, 2022

ramu-actyv commented Mar 1, 2023

nkiesel commented Mar 8, 2023

danielkochengineer commented Aug 28, 2023

suryapandian commented Sep 15, 2023

Ahmadre commented Oct 11, 2023

selvarajshanmugam commented Nov 2, 2023 • edited Loading

windowye commented Nov 13, 2023

IPv6 commented Dec 5, 2023

maganap commented Jan 25, 2024 • edited Loading

stepbystepcode commented Feb 1, 2024

yuannight commented Jun 5, 2024

houskii commented Jul 25, 2024

adrienjoly commented Mar 27, 2022 •

edited

Loading

nescroft commented Aug 2, 2022 •

edited

Loading

selvarajshanmugam commented Nov 2, 2023 •

edited

Loading

maganap commented Jan 25, 2024 •

edited

Loading