Azure App Service部署Node.js应用遇容器端口探测失败求助

核心问题分析 #

Azure App Service Linux默认会对容器的8080端口执行HTTP健康检查，若你的Next.js/Nest.js应用未在该端口监听，或启动过程出现异常，就会触发容器退出的错误。

具体修复步骤 #

1. 强制应用监听8080端口 #

• Next.js：修改package.json的启动脚本，指定端口为8080：

  "scripts": {
    "start": "next start -p 8080"
  }
  

• Nest.js：在main.ts中让应用绑定8080端口（优先读取Azure的PORT环境变量）：

  async function bootstrap() {
    const app = await NestFactory.create(AppModule);
    await app.listen(process.env.PORT || 8080);
  }
  bootstrap();
  

2. 配置Azure App Service启动命令 #

在Azure门户进入你的应用服务 → 配置 → 常规设置，在启动命令栏填写对应脚本：

• 前端Next.js：npm run start
• 后端Nest.js：npm run start:prod（需与你package.json中的生产启动脚本一致）

3. 检查GitHub Actions部署配置 #

确保部署动作中正确传递端口环境变量，示例azure/webapps-deploy配置：

- name: Deploy to Azure Web App
  uses: azure/webapps-deploy@v2
  with:
    app-name: 'costosapp-prueba'
    slot-name: 'production'
    publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
    package: .
    env:
      PORT: 8080

4. 排查容器启动日志 #

进入Azure门户 → 应用服务 → 日志 → 容器日志，查看具体启动报错：

• 若出现依赖缺失：检查package-lock.json/yarn.lock是否已提交到GitHub仓库
• 若出现端口占用：确认应用未硬编码其他端口，或Azure环境中无端口冲突
• 若出现启动命令错误：核对启动脚本名称是否与package.json定义一致

5. （可选）Dockerfile正确配置（若使用） #

如果手动添加Dockerfile，需确保暴露8080端口并指定正确启动命令：

Next.js Dockerfile示例

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
EXPOSE 8080
CMD ["npm", "run", "start"]

Nest.js Dockerfile示例

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
EXPOSE 8080
CMD ["node", "dist/main.js"]

同时在Azure门户配置→常规设置中，将容器端口设为8080。

6. 本地验证应用可用性 #

在本地终端设置环境变量后启动应用，验证8080端口可正常访问：

# 终端设置端口
export PORT=8080
# 启动应用
npm run start

访问http://localhost:8080确认应用正常运行，排除代码本身问题。

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