Docker部署Node应用遇sqlite3 MODULE_NOT_FOUND错误求助

问题核心 #

本地MacOS运行正常，但Docker部署后报错：

Error: Cannot find module '/src/node_modules/sqlite3/lib/binding/napi-v6-linux-musl-x64/node_sqlite3.node'

原因分析 #

sqlite3是包含原生C++扩展的Node模块，不同操作系统/系统库需要对应预编译的二进制文件：

• 本地MacOS执行npm install时，下载的是适配darwin（Mac）系统的二进制
• 你的Docker镜像用的是Alpine系统（基于musl libc），需要适配linux-musl-x64的二进制
• 但docker-compose里把本地目录.挂载到了容器/src，导致容器内的node_modules被本地Mac的版本覆盖，找不到Alpine需要的二进制文件

解决方案 #

方案1：保留本地挂载但排除node_modules（推荐） #

修改docker-compose.yml的volumes配置，添加匿名卷来隔离容器内的node_modules，避免本地版本干扰：

version: "3.7"
services:
  api:
    image: test/api
    build: ./
    command: npm start
    restart: on-failure
    environment:
      SERVER_PORT: 3004
      TOKEN_KEY: test123
    volumes:
      - .:/src
      - /src/node_modules  # 新增：让容器使用自身安装的依赖
    ports:
      - "3004:3004"

这样既保留本地代码热更新的能力，又能让容器使用构建阶段安装的适配Alpine的依赖。

方案2：移除本地目录全量挂载（适合生产环境） #

如果不需要本地代码实时同步到容器，可以直接删除volumes中的本地目录挂载，完全使用镜像内的代码和依赖：

version: "3.7"
services:
  api:
    image: test/api
    build: ./
    command: npm start
    restart: on-failure
    environment:
      SERVER_PORT: 3004
      TOKEN_KEY: test123
    ports:
      - "3004:3004"

镜像构建时已经将本地代码复制到容器内，无需额外挂载。

方案3：临时修复：进入容器重新安装依赖 #

仅用于临时测试场景，进入容器重新执行依赖安装，强制在Alpine环境下编译sqlite3：

# 查看运行中的容器ID
docker ps
# 进入容器终端
docker exec -it <容器ID> sh
# 重新安装依赖
npm install

注意：此方法每次重建容器都需要重复操作，不适合长期使用。

内容的提问来源于stack exchange，提问作者user21116899