同一项目中Angular+Node.js部署至Azure App Service遇后端启动问题

针对你的Angular+Node.js单项目在Azure App Service后端无法启动的问题，按以下步骤逐一排查：

1. 确认package.json启动命令正确性 #

确保package.json的scripts字段包含正确的后端启动命令，Azure默认会执行npm start，示例配置：

"scripts": {
  "start": "node server.js",
  "build": "ng build --prod"
}

如果你的启动命令不是start，需要在Azure门户手动指定启动命令（见下文第4点）。

2. 检查部署文件结构 #

Azure App Service的默认运行目录是site/wwwroot，必须保证以下文件位置正确：

• site/wwwroot/server.js：后端入口文件直接放在根目录，而非dist子目录内
• site/wwwroot/package.json：项目依赖配置文件在根目录
• site/wwwroot/dist/：Angular构建后的静态文件存放于此

如果部署时误将dist设为根目录，后端文件会找不到，导致启动失败。

3. 修正端口配置 #

Azure会分配动态端口，通过环境变量PORT提供，禁止硬写固定端口，修改server.js的端口监听代码：

const express = require('express');
const app = express();
// 其他后端逻辑...

// 正确获取端口
const port = process.env.PORT || 3000;
app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

硬写端口会导致Azure无法映射服务端口，后端进程无法对外提供服务。

4. 配置Azure App Service启动设置 #

登录Azure门户，进入你的App Service：

• 导航至配置 > 常规设置
• 确认运行时堆栈选择了与本地一致的Node.js版本（如18.x、20.x）
• 若package.json的start命令正确，启动命令可留空；否则手动填写node server.js

5. 查看日志定位具体错误 #

通过日志可以快速定位问题：

• 方法1：在Azure门户进入日志流，实时查看后端启动的错误输出
• 方法2：进入高级工具 > Kudu > 调试控制台 > CMD，查看LogFiles目录下的application.log或npm-debug.log，里面会包含具体的报错信息（如依赖缺失、语法错误等）

6. 确认后端依赖配置 #

确保package.json的dependencies字段包含所有后端必需的包（如express、cors等），不要将后端依赖放在devDependencies中——Azure生产环境部署时不会安装devDependencies内的包。

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