启动机器人遇ERR_DLOPEN_FAILED错误，常规修复方法无效求助

问题原因 #

你的canvas模块是用Node.js v18（对应NODE_MODULE_VERSION 108）编译的，但当前运行环境用的是Node.js v20（对应NODE_MODULE_VERSION 115），两者版本不兼容导致模块加载失败。普通的npm rebuild/npm install可能因为缓存残留或缺少编译依赖没生效。

错误信息（翻译后） #

错误：模块 '/home/container/node_modules/canvas/build/Release/canvas.node'
是针对不同的Node.js版本编译的，使用的NODE_MODULE_VERSION为108。当前Node.js版本需要的NODE_MODULE_VERSION为115。请尝试重新编译或重新安装该模块（例如使用`npm rebuild`或`npm install`）。
    在 Object.Module._extensions..node (node:internal/modules/cjs/loader:1327:18)
    在 Module.load (node:internal/modules/cjs/loader:1091:32)
    在 Function.Module._load (node:internal/modules/cjs/loader:938:12)
    在 Module.require (node:internal/modules/cjs/loader:1115:19)
    在 require (node:internal/modules/helpers:130:18)
    在 Object.<anonymous> (/home/container/node_modules/canvas/lib/bindings.js:3:18)
    在 Module._compile (node:internal/modules/cjs/loader:1241:14)
    在 Module._extensions..js (node:internal/modules/cjs/loader:1295:10)
    在 Object.require.extensions.<computed> [as .js] (/usr/local/lib/node_modules/ts-node/src/index.ts:1608:43)
    在 Module.load (node:internal/modules/cjs/loader:1091:32) {
  code: 'ERR_DLOPEN_FAILED'
}

解决步骤 #

• 彻底清理旧依赖和缓存

  rm -rf node_modules
  rm package-lock.json
  npm cache clean --force
  

• 安装canvas编译所需的系统依赖（根据你的操作系统选择）
  • Debian/Ubuntu：

    apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
    

  • CentOS/RHEL：

    yum install gcc-c++ cairo-devel pango-devel libjpeg-turbo-devel giflib-devel
    

  • macOS：

    brew install pkg-config cairo pango libpng jpeg giflib librsvg
    

• 重新安装依赖，强制从源码编译canvas

  npm install
  # 若上述命令无效，单独重新安装canvas
  npm install canvas --build-from-source
  

• （可选）统一Node.js版本
  如果不想折腾编译，直接切换到与模块编译时匹配的Node版本：

  # 用nvm安装并切换到v18
  nvm install 18
  nvm use 18
  # 或者升级到v20确保环境一致
  nvm install 20
  nvm use 20
  

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