Azure WebApp部署失败无明确错误，如何获取日志排查？

一、Oryx构建失败的日志排查 #

• 直接查看完整Oryx构建日志：在Azure门户的WebApp资源中，进入部署中心 → 日志标签，勾选“显示完整日志”，这里能看到Oryx构建的所有步骤，包括依赖安装、编译过程的详细报错，之前的简化日志大概率漏掉了关键信息。
• 本地预验证构建：在本地执行yarn build和cd api && az webapp up --dry-run，先确认本地构建是否正常，排除代码本身的问题。如果本地构建失败，先修复本地问题再部署。
• 查看Kudu的构建日志：访问https://<你的WebApp名称>.scm.azurewebsites.net/DebugConsole，进入site/deployments/latest/logs目录，查看build.log和deploy.log，里面是Oryx构建的完整输出。

二、ACR容器部署的日志排查 #

• 查看容器运行日志：在Azure门户WebApp的容器标签 → 日志，这里能看到容器启动的全量日志，包括镜像拉取、初始化、应用启动的报错信息，比如端口映射错误、环境变量缺失、依赖未安装等。
• 远程连接容器调试：在Kudu控制台中，进入容器 → 远程连接，直接进入容器内部，执行ps aux查看进程状态，或者手动启动应用（比如gunicorn app:app或npm start），观察实时报错。
• 检查容器启动命令：确认Dockerfile中的CMD或ENTRYPOINT是否正确，比如Flask应用是否指定了正确端口（Azure WebApp默认监听8080端口），React静态文件是否配置了正确的服务（比如用nginx代理）。
• 查看ACR镜像推送日志：在ACR资源的存储库 → 对应镜像的标签 → 历史记录，确认镜像是否成功构建并推送，有没有构建过程中的错误。

三、通用日志排查手段 #

• 启用WebApp诊断日志：在Azure门户WebApp的诊断设置中，启用“应用日志（文件系统）”、“Web服务器日志”和“详细错误日志”，设置保留时间后，日志会存储在site/wwwroot/logs目录，也可通过Log Analytics查看聚合日志。
• 查看应用内部日志：在Flask应用中配置日志输出到文件（比如logging.basicConfig(filename='app.log', level=logging.DEBUG)），React应用在生产环境开启调试模式（修改package.json中的build命令为react-scripts build --debug），然后通过Kudu控制台查看生成的日志文件。

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