Node.js应用部署GKE时nodemon无法启动问题求助

从你提供的nodemon启动日志可以直接定位到核心问题：nodemon进程收到的参数不符合预期，直接打印帮助文档后退出，导致服务没有正常启动。

1 修复nodemon启动失败问题 #

原因 #

npm在容器的非交互式shell环境下执行脚本时，默认不会将项目本地node_modules/.bin路径加入PATH变量，如果你没有全局安装npm-run-all、nodemon、webpack这些依赖，或者全局版本和项目本地依赖版本不兼容，就会出现参数解析异常，触发nodemon的帮助提示。

修复方案 #

修改package.json的scripts配置，所有项目本地依赖的可执行文件统一用npx调用，确保调用的是项目本地安装的对应版本：

"scripts": {
  "dev": "npx npm-run-all --parallel dev:build-server dev:build-client  dev:server",
  "dev:server": "npx nodemon -L --watch build --exec node build/bundle.js",
  "dev:build-server": "npx webpack --config webpack.server.js --watch",
  "dev:build-client": "npx webpack --config webpack.client.js --watch"
}

同时调整Dockerfile的启动命令，改为shell格式确保环境变量正常加载：
把原有CMD ["npm", "run", "dev" ]替换为：

CMD npm run dev

2 修复手动启动后路由找不到问题 #

按上述方案修复启动问题后，如果还存在路由访问异常，按以下顺序排查：

• 确认应用监听地址为0.0.0.0：不要写死为127.0.0.1，否则K8s的Service无法转发外部请求到Pod内的服务，需要在服务启动代码里明确指定监听地址，示例：app.listen(3001, '0.0.0.0')
• 等待构建完成再访问：dev模式下webpack需要先完成服务端和客户端代码的构建，生成build/bundle.js之后nodemon才会启动服务，构建期间访问会出现路由不存在的问题
• 检查K8s配置：确认Service的targetPort匹配3001，Ingress的路径规则和应用的路由配置一致，如果Ingress配置了路径前缀，需要给应用配置对应的base路径

额外建议 #

如果是生产环境部署到GKE，不建议使用dev模式启动服务，dev模式带的文件监听、热重载能力都是开发场景使用的，生产环境可以提前构建好产物，直接用node build/bundle.js启动服务，不需要依赖nodemon、webpack watch，稳定性和性能都更好。

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