Azure Web App部署Python(Django)应用报错求助

问题背景 #

基于微软官方Django快速启动项目修改的应用，原基础版本通过GitHub Actions部署到Azure App Service正常。新增应用代码提交部署后，出现网关错误及500错误，日志流未提供有效排查信息。

报错截图 #

排查与修复步骤 #

1. 核对Django核心配置

   • 生产环境下DEBUG=False时，ALLOWED_HOSTS必须包含Azure应用的域名（格式：<你的应用名>.azurewebsites.net），缺失会直接触发500错误。
   • 临时开启DEBUG=True（仅限排查，排查后关闭），访问应用会显示详细错误栈，快速定位代码或配置问题。

2. 验证GitHub Actions部署流程

   • 确认requirements.txt已添加新增应用的所有依赖包，部署脚本执行了pip install -r requirements.txt。
   • 检查部署脚本是否包含数据库迁移命令：python manage.py migrate，新增模型或修改数据库结构后必须执行迁移。
   • 确认Azure App Service的环境变量配置完整：SECRET_KEY、数据库连接字符串等关键配置项需在应用服务→配置→应用设置中正确设置。

3. 获取Azure详细日志

   • 在Azure门户开启详细错误日志：进入应用服务→监控→应用服务日志，开启“详细错误日志（文件系统）”和“日志流”，重新触发错误后查看/home/LogFiles目录下的django.log或web.config相关日志。
   • 用Azure CLI拉取全量日志本地分析：

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

4. 检查静态文件处理

   • 确认部署脚本执行了静态文件收集命令：python manage.py collectstatic --noinput，Azure会自动映射收集后的静态文件。
   • 新增应用的静态文件路径是否符合Django配置，STATIC_ROOT和STATIC_URL设置正确。

5. 本地生产模式复现

   • 在本地设置DEBUG=False并配置对应环境变量，运行应用python manage.py runserver --insecure，尝试复现错误，提前在本地定位问题。

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