如何在Docker启动时执行node -r esm app.js命令？

• 校验依赖安装完整性
  • 确认esm已经放在package.json的dependencies字段，而非仅存在于devDependencies，Docker生产环境默认只会安装生产依赖，开发依赖不会被打包进镜像。
  • 检查Dockerfile中的依赖安装逻辑，确认执行了npm install或npm ci --only=production，无跳过依赖安装的错误配置。
• 校验启动命令配置
  • 确认Dockerfile的CMD指令、或docker-compose的command配置、或容器内进程管理工具的启动参数，完全匹配本地命令node -r esm app.js，不要遗漏-r esm的注入参数。
  • 如果使用pm2作为进程管理工具，需要在pm2配置文件中显式指定node参数，示例配置如下：

  {
    "name": "your-app",
    "script": "app.js",
    "node_args": "-r esm"
  }
  

• 校验Node版本兼容性
  • 确认Docker镜像内的Node.js大版本和本地开发环境完全一致，esm包对过新或过旧的Node版本都可能存在兼容问题，推荐统一使用14.x、16.x这类长期支持版本。
  • 若你使用的Node版本已经支持原生ES模块（可通过在package.json中添加"type": "module"启用），可排查是否是原生ES模块规则和esm包的加载逻辑冲突，冲突时可二选其一使用。
• 校验路径与权限配置
  • 确认Dockerfile中设置的WORKDIR正确，启动命令执行的工作目录下存在node_modules/esm目录，无esm包路径查找失败的问题。
  • 确认容器内运行Node进程的用户，对node_modules目录有可读权限，避免权限不足导致esm加载失败。

如果以上步骤排查后仍未解决问题，可在启动命令前添加NODE_DEBUG=module参数，打印模块加载的全链路日志，定位具体加载失败的节点。

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