Docker内Node.js语法报错但外部正常的排查求助

兄弟快别崩溃了！我之前碰到过一模一样的情况，这个语法错误跟WSL2关系不大，核心问题是你的index.js没被Node解释器执行，反而被shell当成脚本跑了——shell哪看得懂console.log啊！

最可能的元凶：yarn start 没调用Node #

先去检查你的package.json里的scripts字段，是不是写成这样了：

"scripts": {
  "start": "./app/index.js"
}

如果是，那问题就找到了！直接运行.js文件时，Linux容器会默认用当前shell去解析它，而不是Node，所以才会报shell语法错误。

修复方法 #

把start脚本改成明确调用Node：

"scripts": {
  "start": "node ./app/index.js"
}

另一种可能：想直接运行JS文件但没做对配置 #

如果你非要直接运行./app/index.js而不写node命令，得满足两个条件：

1. 在index.js第一行加上Shebang头，告诉系统用Node执行：

   #!/usr/bin/env node
   console.log("HI");
   

2. 给文件加可执行权限，在Dockerfile里加一行：

   RUN chmod +x ./app/index.js
   

不过说实话，在容器里还是直接写node ...更稳妥，少折腾。

快速验证法 #

要是你懒得改package.json，可以先修改Dockerfile的CMD直接测试：

CMD ["node", "./app/index.js"]

如果这样容器能正常输出HI，那百分百是yarn start的脚本配置问题。

关于WSL2的小补充 #

虽然这次不是它的锅，但万一上面的方法都没用，可以检查下文件换行符：Windows的CRLF换行在Linux容器里可能搞砸Shebang头（比如变成#!/usr/bin/env node\r，系统找不到这个命令）。你可以用dos2unix转换，或者在Git里设置自动转：

git config --global core.autocrlf input

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