Next.js容器部署至Azure App Service异常排查求助

1. 端口不匹配导致默认页面问题 #

Azure App Service 默认要求容器监听 80 或 8080 端口，你的日志显示应用监听8081，平台无法正确路由请求，因此显示默认页面。修复方式：

• 在Dockerfile中添加端口暴露指令：EXPOSE 8080
• 配置环境变量让Next.js监听指定端口：
  • Dockerfile里添加：ENV PORT=8080
  • 或在Azure App Service配置中心新增环境变量PORT，值设为8080

2. 修复启动命令的语法错误 #

你修改的启动命令node"standalone/server.js存在语法错误，node命令与路径间缺少空格，正确写法：

node standalone/server.js

若在Dockerfile中配置，推荐使用exec格式避免shell解析问题：

CMD ["node", "standalone/server.js"]

3. 确认standalone模式的路径与依赖完整性 #

通过SSH确认server.js位于/home/site/wwwroot/standalone/server.js，需确保：

• Dockerfile中设置正确工作目录：WORKDIR /home/site/wwwroot，保证启动命令的路径指向正确
• 打包阶段完整复制standalone相关文件，Dockerfile需包含：

  COPY --from=builder /app/.next/standalone ./
  COPY --from=builder /app/.next/static ./.next/static
  COPY --from=builder /app/public ./public
  

4. 排查容器重启的具体原因 #

若修改后仍重启，通过以下方式定位错误：

• 打开Azure App Service左侧菜单的「日志流」，实时查看容器启动的报错信息
• 通过SSH进入容器，手动执行node standalone/server.js，观察终端输出的具体错误（如模块缺失、路径错误等）

适配Azure的完整Dockerfile示例 #

# 构建阶段
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# 运行阶段
FROM node:18-alpine
WORKDIR /home/site/wwwroot
ENV PORT=8080
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 8080
CMD ["node", "server.js"]

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