部署Next.js应用至Azure App Service启动失败问题排查求助

首次尝试将Next.js应用部署至Azure App Service，使用的Dockerfile如下：

FROM node:21.1.0
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "run", "dev"]

访问站点时出现无限加载后失败的情况，部署日志显示以下错误：

2023-12-05T23:03:36.663Z ERROR - Container appname_0_d945e9e7 for site teacherassistant7842 has exited, failing site start
2023-12-05T23:03:36.668Z ERROR - Container appname_0_d945e9e7 didn't respond to HTTP pings on port: 3000, failing site start. See container logs for debugging.
2023-12-05T23:03:36.684Z INFO - Stopping site appname because it failed during startup.

请问该错误的可能原因是什么？另外我一直找不到容器日志的位置，也请告知相关信息。

可能的错误原因 #

• 开发服务器绑定地址限制：npm run dev启动的Next.js开发服务器默认只监听localhost，Azure App Service的健康检查无法通过容器网络访问localhost端口。需修改启动命令，让服务器监听所有网络接口，例如：

  CMD ["npm", "run", "dev", "--", "-H", "0.0.0.0"]
  

• 错误使用开发环境部署：npm run dev是开发模式，性能、稳定性不适合生产环境部署。正确流程应为先执行生产构建，再启动生产服务器，调整Dockerfile如下：

  FROM node:21.1.0
  WORKDIR /app
  COPY package*.json ./
  RUN npm install
  COPY . .
  RUN npm run build
  EXPOSE 3000
  CMD ["npm", "start"]
  

  同时确保package.json中包含start脚本："start": "next start -p 3000"
• 端口配置不匹配：确认Next.js实际监听端口为3000，且Azure App Service的配置中（“配置”->“常规设置”）的“端口”项设置为3000。
• 依赖安装异常：若npm install过程中存在未捕获的错误（如缺失系统依赖、网络问题导致包未下载完成），会导致容器启动时无法正常初始化服务器。可查看容器日志确认具体依赖问题。

容器日志查看方式 #

• Azure门户日志流：进入目标App Service资源，左侧菜单“监测”下选择“日志流”，实时查看容器输出日志。
• Azure CLI命令：在终端执行以下命令，实时拉取日志：

  az webapp log tail --name <你的应用名称> --resource-group <资源组名称>
  

• Kudu控制台：访问https://<你的应用名称>.scm.azurewebsites.net，进入“Debug console” -> “CMD”/“PowerShell”，导航到/home/LogFiles/Application目录，查看存储的日志文件。

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