Azure部署Node.js API启动失败，未用Docker却报容器端口异常

问题本质 #

Azure App Service 即使不使用自定义Docker镜像，也会通过容器化环境运行你的应用，平台默认会对8080端口进行健康探测。你的Express服务在3000端口启动，但探测请求无法触达，最终导致容器启动超时、站点部署失败。

具体解决方案 #

1. 用环境变量动态监听端口

Azure会自动为应用分配PORT环境变量（默认值通常为8080），不要硬编码端口号，改为读取该变量：

const port = process.env.PORT || 3000;
// 必须绑定到0.0.0.0，否则容器外部无法访问
app.listen(port, '0.0.0.0', () => {
  console.log(`Server running on port ${port}`);
});

如果之前硬编码修改为8080仍无效，大概率是因为应用绑定了127.0.0.1（仅容器内部可访问），改为0.0.0.0才能让Azure的探测请求正常触达。

2. 检查并修正健康探测配置

进入Azure门户你的App Service控制台：

• 左侧导航栏选择「配置」→「常规设置」
• 找到「健康检查」模块：
  • 确保探测路径是你的API可访问的端点（比如/或专门的/health，如果没有健康端点，可临时添加一个简单的路由：app.get('/health', (req, res) => res.sendStatus(200))）
  • 端口设置留空（默认使用应用监听的PORT变量值），不要手动指定固定端口

3. 确认启动命令正确

如果Azure默认的启动逻辑未正确触发你的应用：

• 同样在「配置」→「常规设置」的「启动命令」中，手动指定启动脚本，比如：
  • 若package.json中有"start": "node server.js"，则填npm start
  • 直接启动文件则填node server.js（替换为你的入口文件名）

4. 验证日志定位问题

通过Azure门户的「日志」→「日志流」查看：

• 应用日志：确认服务实际启动的端口、是否绑定到0.0.0.0
• 平台日志：查看探测失败的具体细节（比如连接超时、返回4xx/5xx状态码）

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