Django部署Azure Web App静态文件无法加载求助

核心排查步骤与修复方法 #

1. 确认collectstatic命令已执行

   • Django生产环境依赖collectstatic将所有静态文件收集到STATIC_ROOT指定的目录，Azure会从该目录读取静态资源。
   • 本地先执行：

     python manage.py collectstatic
     

   • 检查项目根目录下的staticfiles文件夹是否生成，且包含services/static下的所有静态文件（CSS、JS、图片等）。
   • 部署到Azure时，必须确保部署流程中包含该命令：
     • 若用GitHub Actions/Azure DevOps，在部署步骤添加collectstatic；
     • 若用Azure CLI部署，先SSH到应用服务实例执行该命令。

2. 验证静态文件路径配置

   • 检查settings.py中BASE_DIR的定义是否正确（通常为BASE_DIR = Path(__file__).resolve().parent.parent），避免路径拼接错误。
   • 确认STATICFILES_DIRS指向的services/static目录真实存在，拼写无大小写错误（Linux环境下路径区分大小写）。

3. 配置Azure应用服务静态文件规则

   • 登录Azure门户，进入你的应用服务：
     1. 前往「配置」→「常规设置」，启用「静态文件」选项；
     2. 添加静态文件映射：虚拟路径设为/static/，物理路径设为/home/site/wwwroot/staticfiles（对应STATIC_ROOT的绝对路径）；
     3. 确认「应用程序设置」中已配置DJANGO_SETTINGS_MODULE指向你的settings文件（如myproject.settings）。

4. 修正urls.py与生产环境配置

   • 生产环境（DEBUG=False）下，static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)不会生效，Django不会处理静态文件请求，需由Azure的Web服务器直接提供。
   • 确保settings.py中DEBUG=False，ALLOWED_HOSTS包含你的域名standingrock.azurewebsites.net。

5. 检查STATICFILES_STORAGE配置

   • 若使用默认的StaticFilesStorage，确保无配置冲突；生产环境可考虑切换为ManifestStaticFilesStorage优化缓存，但需先解决基础加载问题：

     STATICFILES_STORAGE = "django.contrib.staticfiles.storage.ManifestStaticFilesStorage"
     

常见错误排查 #

• 若staticfiles目录为空：检查STATICFILES_DIRS路径是否正确，或是否有文件权限问题；
• 若Azure返回404：确认静态文件映射的虚拟路径与STATIC_URL一致，物理路径指向正确的staticfiles目录；
• 若本地正常但部署后失败：检查部署时是否跳过了collectstatic步骤，或Azure环境的BASE_DIR与本地不一致。

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