运行Docker容器时提示“linux is NOT supported”的排查求助

1. 定位错误来源 #

• 进入容器手动调试：
  运行 docker run -it --entrypoint sh myContainer 进入容器终端，执行 node src/index.js 尝试获取更多上下文；也可以用 node --trace-warnings src/index.js 或 node --inspect src/index.js 开启调试模式，捕捉更详细的执行日志。
• 搜索错误字符串：
  在容器内执行 grep -r "linux is NOT supported" /app，覆盖项目代码和 node_modules 目录，定位输出该错误的具体文件。本地可复现的话，也能直接在项目目录执行同样的搜索命令。
• 检查预启动脚本：
  查看 package.json 中的 scripts 字段，确认是否存在 prestart 等钩子脚本，这类脚本可能在 npm start 执行前运行并输出错误。

2. 针对性排查 #

• 若错误来自项目代码：
  找到对应的代码逻辑（通常是检查 process.platform 的判断），确认是否误将 linux 标记为不支持的操作系统，修正判断逻辑即可。
• 若错误来自依赖包：
  定位到具体依赖后，查看该包的官方文档，确认是否支持Linux环境；尝试升级/降级该依赖版本，或寻找功能替代的包。同时检查依赖是否匹配容器的CPU架构——执行 docker inspect myContainer | grep Architecture 查看架构，确认依赖是否支持该架构。
• 排除环境差异：
  在本地Linux环境（如WSL）直接运行 npm start，看是否出现相同错误，以此判断问题是否与Docker容器化相关。

3. 额外调试手段 #

• 执行 npm start --verbose 启动项目，获取更详细的npm执行日志，排查是否有隐藏的错误信息。
• 尝试在Dockerfile中添加 RUN grep -r "linux is NOT supported" /app 命令，在构建阶段就定位错误来源，提前排查问题。

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