Cannot find module '@oxc-parser

[hlassiege]

Environment

• Operating System: Windows_NT
• Node Version: v20.18.0
• Nuxt Version: ^4.1.3
• CLI Version: 3.29.3
• Nitro Version: 2.12.7
• Package Manager: unknown
• Builder: -
• User Config: compatibilityDate, devtools
• Runtime Modules: -
• Build Modules: -

---

Reproduction

How to reproduce :

npm create nuxt@latest oxc --compatibilityVersion=4
Need to install the following packages:
create-nuxt@3.29.3
...
√ Which package manager would you like to use?
npm
and that's all.

I can reproduce it on windows and debian.

The code is also here:

https://github.com/hlassiege/oxc

but nothing fancy, it's only the result of npm create nuxt@latest oxc

Describe the bug

I can't build an application. I have the same error each time saying that oxc-parser don't have a native binding available.

On debian (distant env, deployed on coolify) :

#11 9.194 [error] Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try `npm i` again after removing both package-lock.json and node_modules directory.
2025-Oct-14 17:17:58.031442
#11 9.194   at node_modules/oxc-parser/src-js/bindings.js:553:11
2025-Oct-14 17:17:58.031442
#11 9.194   at ModuleJob.run (node:internal/modules/esm/module_job:195:25)
2025-Oct-14 17:17:58.031442
#11 9.194   at async ModuleLoader.import (node:internal/modules/esm/loader:337:24)
2025-Oct-14 17:17:58.031442
#11 9.194   at async loadNuxt (node_modules/@nuxt/kit/dist/index.mjs:946:35)
2025-Oct-14 17:17:58.031442
#11 9.194   at async Object.run (node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)
2025-Oct-14 17:17:58.031442
#11 9.194   at async runCommand (node_modules/citty/dist/index.mjs:316:16)
2025-Oct-14 17:17:58.031442
#11 9.194   at async runCommand (node_modules/citty/dist/index.mjs:307:11)
2025-Oct-14 17:17:58.031442
#11 9.194   at async runMain (node_modules/citty/dist/index.mjs:445:7)
2025-Oct-14 17:17:58.031442
#11 9.194
2025-Oct-14 17:17:58.031442
#11 9.194   [cause]: Cannot find module '@oxc-parser/binding-linux-x64-gnu'

Or on Windows (local dev)

 ERROR  Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try npm i again after removing both package-lock.json and node_modules directory.              19:05:05

    at /C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:553:11
    at ModuleJob.run (node:internal/modules/esm/module_job:234:25)
    at async ModuleLoader.import (node:internal/modules/esm/loader:473:24)
    at async loadNuxt (/C:/Dev/src/blog/app/node_modules/@nuxt/kit/dist/index.mjs:946:35)
    at async Object.run (/C:/Dev/src/blog/app/node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)
    at async runCommand (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:316:16)
    at async runCommand (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:307:11)
    at async runMain (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:445:7)

  [cause]: Cannot find module '@oxc-parser/binding-win32-x64-msvc'

Additional context

Issue also opened on oxc : oxc-project/oxc#14598

Logs

C:\Dev\src\blog\app>npm ci
npm warn deprecated @types/parse-path@7.1.0: This is a stub types definition. parse-path provides its own type definitions, so you do not need this installed.
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported

> postinstall
> nuxt prepare


 ERROR  Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try npm i again after removing both package-lock.json and node_modules directory.              19:05:05

    at /C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:553:11
    at ModuleJob.run (node:internal/modules/esm/module_job:234:25)
    at async ModuleLoader.import (node:internal/modules/esm/loader:473:24)
    at async loadNuxt (/C:/Dev/src/blog/app/node_modules/@nuxt/kit/dist/index.mjs:946:35)
    at async Object.run (/C:/Dev/src/blog/app/node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)
    at async runCommand (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:316:16)
    at async runCommand (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:307:11)
    at async runMain (/C:/Dev/src/blog/app/node_modules/citty/dist/index.mjs:445:7)

  [cause]: Cannot find module '@oxc-parser/binding-win32-x64-msvc'
Require stack:
- C:\Dev\src\blog\app\node_modules\oxc-parser\src-js\bindings.js

      at Module._resolveFilename (node:internal/modules/cjs/loader:1225:15)
      at Module._load (node:internal/modules/cjs/loader:1051:27)
      at Module.require (node:internal/modules/cjs/loader:1311:19)
      at require (node:internal/modules/helpers:179:18)
      at requireNative (/C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:118:25)
      at /C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:512:17
      at ModuleJob.run (node:internal/modules/esm/module_job:234:25)
      at async ModuleLoader.import (node:internal/modules/esm/loader:473:24)
      at async loadNuxt (/C:/Dev/src/blog/app/node_modules/@nuxt/kit/dist/index.mjs:946:35)
      at async Object.run (/C:/Dev/src/blog/app/node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)

    [cause]: Cannot find module './parser.win32-x64-msvc.node'
Require stack:
- C:\Dev\src\blog\app\node_modules\oxc-parser\src-js\bindings.js

        at Module._resolveFilename (node:internal/modules/cjs/loader:1225:15)
        at Module._load (node:internal/modules/cjs/loader:1051:27)
        at Module.require (node:internal/modules/cjs/loader:1311:19)
        at require (node:internal/modules/helpers:179:18)
        at requireNative (/C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:113:16)
        at /C:/Dev/src/blog/app/node_modules/oxc-parser/src-js/bindings.js:512:17
        at ModuleJob.run (node:internal/modules/esm/module_job:234:25)
        at async ModuleLoader.import (node:internal/modules/esm/loader:473:24)
        at async loadNuxt (/C:/Dev/src/blog/app/node_modules/@nuxt/kit/dist/index.mjs:946:35)
        at async Object.run (/C:/Dev/src/blog/app/node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)



 ERROR  Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try npm i again after removing both package-lock.json and node_modules directory.              19:05:05

npm error code 1
npm error path C:\Dev\src\blog\app

[github-actions]

Stackblitz link for the reproduction: Stackblitz

[Flo0806]

use node 22.20 then the problem should be gone.

[hlassiege]

use node 22.20 then the problem should be gone.

I am on node 22.19 on coolify. And I still have the problem

2025-Oct-14 18:49:52.101512
╔══════════════ Nixpacks v1.40.0 ═════════════╗
2025-Oct-14 18:49:52.101512
║ setup      │ nodejs_22, npm-9_x, curl, wget ║
2025-Oct-14 18:49:52.101512
║─────────────────────────────────────────────║
2025-Oct-14 18:49:52.101512
║ install    │ npm ci                         ║
2025-Oct-14 18:49:52.101512
║─────────────────────────────────────────────║
2025-Oct-14 18:49:52.101512
║ build      │ npm run build                  ║
2025-Oct-14 18:49:52.101512
║─────────────────────────────────────────────║
2025-Oct-14 18:49:52.101512
║ start      │                                ║
2025-Oct-14 18:49:52.101512
╚═════════════════════════════════════════════╝

#11 [stage-0  7/11] RUN --mount=type=cache,id=vsoo484cc0goggw4s4oc808w-/root/npm,target=/root/.npm npm ci
....
#11 6.329   [cause]: Cannot find module '@oxc-parser/binding-linux-x64-gnu'
....

[Flo0806]

Ok... Is it possible for you to try it with pnpm? It should work always, absolutly. But there is really a bug in npm. If pnpm throw the same error we must look deeper. The stackblitz link (bot - repo) works as expected with nuxt 4.1.3. Thx!

[hlassiege]

The problem still exist with pnpm
(However with pnpm it works on Windows)

I am lost :)

2025-Oct-14 19:08:40.669009
╔══════════════ Nixpacks v1.40.0 ══════════════╗
2025-Oct-14 19:08:40.669009
║ setup      │ nodejs_22, pnpm-9_x, curl, wget ║
2025-Oct-14 19:08:40.669009
║──────────────────────────────────────────────║
2025-Oct-14 19:08:40.669009
║ install    │ pnpm i --frozen-lockfile        ║
2025-Oct-14 19:08:40.669009
║──────────────────────────────────────────────║
2025-Oct-14 19:08:40.669009
║ build      │ pnpm run build                  ║
2025-Oct-14 19:08:40.669009
║──────────────────────────────────────────────║
2025-Oct-14 19:08:40.669009
║ start      │                                 ║
2025-Oct-14 19:08:40.669009
╚══════════════════════════════════════════════╝

2025-Oct-14 19:08:42.472916
#11 [stage-0  7/11] RUN --mount=type=cache,id=vsoo484cc0goggw4s4oc808w-/root/local/share/pnpm/store/v3,target=/root/.local/share/pnpm/store/v3 pnpm i --frozen-lockfile
2025-Oct-14 19:08:43.151384
#11 0.829 Lockfile is up to date, resolution step is skipped
2025-Oct-14 19:08:43.305650
#11 0.897 Progress: resolved 1, reused 0, downloaded 0, added 0
2025-Oct-14 19:08:43.305650
#11 0.983 Packages: +567
2025-Oct-14 19:08:43.305650
#11 0.983 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2025-Oct-14 19:08:44.220152
#11 1.898 Progress: resolved 567, reused 0, downloaded 159, added 150
2025-Oct-14 19:08:45.220951
#11 2.899 Progress: resolved 567, reused 0, downloaded 361, added 352
2025-Oct-14 19:08:46.222038
#11 3.900 Progress: resolved 567, reused 0, downloaded 566, added 566
2025-Oct-14 19:08:46.403371
#11 3.931 Progress: resolved 567, reused 0, downloaded 567, added 567, done
2025-Oct-14 19:08:46.600647
#11 4.278 .../node_modules/@parcel/watcher install$ node scripts/build-from-source.js
2025-Oct-14 19:08:46.791913
#11 4.279 .../esbuild@0.25.10/node_modules/esbuild postinstall$ node install.js
2025-Oct-14 19:08:46.791913
#11 4.323 .../node_modules/@parcel/watcher install: Done
2025-Oct-14 19:08:46.791913
#11 4.334 .../esbuild@0.25.10/node_modules/esbuild postinstall: Done
2025-Oct-14 19:08:46.791913
#11 4.470
2025-Oct-14 19:08:46.791913
#11 4.470 dependencies:
2025-Oct-14 19:08:46.791913
#11 4.470 + nuxt 4.1.3
2025-Oct-14 19:08:46.791913
#11 4.470 + vue 3.5.22
2025-Oct-14 19:08:46.791913
#11 4.470 + vue-router 4.6.0
2025-Oct-14 19:08:46.791913
#11 4.470
2025-Oct-14 19:08:46.948335
#11 4.475
2025-Oct-14 19:08:46.948335
#11 4.475 > oxc@ postinstall /app
2025-Oct-14 19:08:46.948335
#11 4.475 > nuxt prepare
2025-Oct-14 19:08:46.948335
#11 4.475
2025-Oct-14 19:08:47.574801
#11 5.252 [error] Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try `npm i` again after removing both package-lock.json and node_modules directory.
2025-Oct-14 19:08:47.574801
#11 5.252   at node_modules/.pnpm/oxc-parser@0.94.0/node_modules/oxc-parser/src-js/bindings.js:553:11
2025-Oct-14 19:08:47.574801
#11 5.252   at ModuleJob.run (node:internal/modules/esm/module_job:268:25)
2025-Oct-14 19:08:47.574801
#11 5.252   at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:543:26)
2025-Oct-14 19:08:47.574801
#11 5.252   at async loadNuxt (node_modules/.pnpm/@nuxt+kit@4.1.3_magicast@0.3.5/node_modules/@nuxt/kit/dist/index.mjs:946:35)
2025-Oct-14 19:08:47.574801
#11 5.252   at async Object.run (node_modules/.pnpm/@nuxt+cli@3.29.3_magicast@0.3.5/node_modules/@nuxt/cli/dist/chunks/prepare.mjs:32:18)
2025-Oct-14 19:08:47.574801
#11 5.252   at async runCommand (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:316:16)
2025-Oct-14 19:08:47.574801
#11 5.252   at async runCommand (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:307:11)
2025-Oct-14 19:08:47.574801
#11 5.252   at async runMain (node_modules/.pnpm/citty@0.1.6/node_modules/citty/dist/index.mjs:44

[Flo0806]

Ok... I tried it on Linux Ubuntu 24.x with npm and pnpm, and under Windows with npm 11.6.2 I can#t reproduce the error with your repo. I think you tried to delete the node_modules and run npm i again? On my side all works as well...

I think it will work with npm, too if you delete your node_modules and then try npm i with version 11.6.2 again. But with coolify: If you use a docker contaner, you must set pnpm as your package manager or update npm inside it. Your log (coolify) shows node 22.x but still npm 9.x Thats the problem I think

[hlassiege]

I tried to update npm. But the problem remains.

I guess, maybe it's not the right method to do that.
I'll continue to investigate

2025-Oct-14 20:01:01.940011
╔═══════════ Nixpacks v1.40.0 ═══════════╗
2025-Oct-14 20:01:01.940011
║ setup │ nodejs_22, curl, wget ║
2025-Oct-14 20:01:01.940011
║────────────────────────────────────────║
2025-Oct-14 20:01:01.940011
║ install │ npm install -g npm@11.6.2 ║
2025-Oct-14 20:01:01.940011
║ │ npm install ║
2025-Oct-14 20:01:01.940011
║────────────────────────────────────────║
2025-Oct-14 20:01:01.940011
║ build │ npm run build ║
2025-Oct-14 20:01:01.940011
║────────────────────────────────────────║
2025-Oct-14 20:01:01.940011
║ start │ ║
2025-Oct-14 20:01:01.940011
╚════════════════════════════════════════╝

[hlassiege]

Hi,

It works with latest version of npm

For the record, for people who may read this message in the future :

I use coolify and nixpacks. Within nixpacks it is not possible to set the version of npm (Or I don't know how). So I had to use Coolify with a Dockerfile instead :

(I'll switch back to nixpack in the future)

FROM node:22-alpine AS builder

# Installer les dépendances système nécessaires
RUN apk add --no-cache libc6-compat

WORKDIR /app

COPY package.json package-lock.json* ./

RUN npm install -g npm@latest && \
    npm ci

COPY . .

RUN npm run build

FROM node:22-alpine AS runner

RUN apk add --no-cache curl

WORKDIR /app

COPY --from=builder /app/.output /app/.output
COPY --from=builder /app/package.json /app/package.json

ENV NODE_ENV=production
ENV HOST=0.0.0.0
ENV PORT=3000

EXPOSE 3000

CMD ["node", ".output/server/index.mjs"]

[moshetanzer]

not sure why these issues keep getting closed when they are not resolved?

[Flo0806]

Because it's mostly an npm issue:

 ERROR  Cannot find native binding. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try npm i again after removing both package-lock.json and node_modules directory.              19:05:05

With the current npm version or using pnpm it works as well.

[plcdnl]

@Flo0806 for me doesn't work with pnpm too

[Flo0806]

A lilttle more infos, please @plcdnl :-)
Do you use node 22.20 + pnpm 10.18 (or higher) ?

[hlassiege]

to be fair, pnpm doesn't work either in my case above
but indeed, upgrading npm works