Next.js+Typescript全栈应用部署Azure Web Apps后遇403权限错误求助

问题背景 #

使用Next.js搭配TypeScript开发的全栈应用，通过GitHub部署至Azure Web Apps后，访问网站时提示“您无权查看此目录或页面”。已完成以下操作但问题未解决：

• 本地执行npm run build并测试功能正常
• 确认默认文档包含index.js、index.tsx、index.html
• 无IP限制或认证要求，虚拟路径设为/、物理路径为site\wwwroot
• 尝试添加web.config、通过VS Code重新部署，均无效
• Azure控制台确认所有文件已存在

排查及解决步骤 #

• 确认Next.js部署模式与Azure启动命令

  • 若为静态导出模式（执行过next export）：检查out目录是否部署到wwwroot，或在Azure配置中将物理路径改为site\wwwroot\out
  • 若为SSR/ISR模式：在Azure「配置」→「通用设置」→「启动命令」中添加npm run start，同时确保package.json的scripts里有正确的start命令，例如：

    "scripts": {
      "start": "next start -p $PORT"
    }
    

    Azure会自动注入$PORT环境变量，无需手动指定端口

• 验证环境变量配置

  • 进入Azure「配置」→「应用程序设置」，添加NODE_ENV=production变量
  • 检查是否缺失Next.js运行所需的其他环境变量（如数据库连接串等），缺失可能导致服务启动失败

• 查看详细启动日志

  • 通过Kudu控制台进入LogFiles/Application目录，查看Node.js的详细启动日志，里面会记录依赖缺失、端口冲突等具体错误
  • 对比Log Stream中的错误信息，定位服务启动失败的根因

• 检查部署文件结构

  • 确认wwwroot下是否包含.next目录、package.json及node_modules（若使用Oryx自动构建，node_modules会由Azure自动安装）
  • 若用GitHub Actions部署，检查部署脚本是否正确将build产物上传至wwwroot，确保artifact路径配置无误

• 核对运行时版本

  • 在Azure「配置」→「通用设置」中，确认Node.js版本与本地开发环境一致（如本地用18.x，Azure也需选择18.x），版本不兼容会导致启动异常

• 重置Web App实例

  • 进入Azure Web Apps的「概述」页面，点击「重启」按钮，强制刷新实例状态，排除临时进程异常问题

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