Azure发布管道部署后脚本运行Node.js启动命令的正确性咨询

你的启动方式存在几个关键问题，直接导致了502错误，以下是具体分析和修正方案：

当前启动方式的问题 #

1. 一次性脚本无法维持应用进程：Azure的部署后脚本是一次性执行任务，执行完node main.js后，进程会随着脚本结束而终止，无法保持应用长期运行，这是核心问题。
2. 端口未适配Azure环境：Azure App Service会动态分配端口（通过process.env.PORT环境变量），如果你的NestJS应用硬编码了固定端口（比如3000），会导致应用无法监听正确端口，外部请求无法到达，触发502。
3. 路径与执行上下文风险：部署后脚本的执行路径可能存在不确定因素，若/home/site/wwwroot/apps/workflows路径不存在或文件缺失，会直接导致启动失败。

正确的启动配置方案 #

1. 改用Azure App Service启动命令（推荐） #

放弃部署后脚本，直接在Azure门户配置启动命令：

• 进入App Service的「配置」→「常规设置」
• 在「启动命令」中填入：

  cd /home/site/wwwroot/apps/workflows && node main.js
  

  注：如果依赖必须在部署后安装，可改为：

  cd /home/site/wwwroot/apps/workflows && npm install --only=prod --ignore-scripts && node main.js
  

  Azure会自动维持这个进程的运行，进程意外退出时还会自动重启。

2. 确保NestJS监听正确端口 #

修改NestJS项目的main.ts，强制读取Azure提供的端口：

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 优先使用PORT环境变量，本地开发 fallback 到3000
  await app.listen(process.env.PORT || 3000);
}
bootstrap();

重新用Webpack打包main.js，确保该配置生效。

3. 排查启动日志定位问题 #

如果配置后仍有502，查看Azure的日志流：

• 进入App Service的「监测」→「日志流」
• 查看node main.js执行时的报错信息，常见问题包括：
  • main.js缺失依赖相关的编译代码
  • .env文件未正确加载，导致数据库/配置连接失败
  • 权限不足无法读取文件

4. 优化依赖安装时机（可选） #

将npm install --only=prod移到CI阶段完成，把node_modules目录一起打包部署，避免在App Service上安装依赖时出现网络或权限问题，提升部署稳定性。

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