Azure App Service上Django Admin静态文件500错误请求协助

问题核心 #

该错误通常源于Django FileResponse与WSGI服务器兼容性问题、静态文件未正确收集，或是自定义代码错误访问了FileResponse的content属性。

解决方案 #

1. 确保静态文件已正确收集 #

Azure App Service不会自动收集Admin静态文件，必须手动执行收集操作：

• 本地预收集后再部署：

  python manage.py collectstatic
  

  该命令会将Admin的静态文件打包到STATIC_ROOT指定的static目录，再同步到Azure服务器。
• 配置Azure启动命令自动收集（推荐）：
  在App Service的Configuration > General settings > Startup Command中设置：

  python manage.py collectstatic --noinput && gunicorn your_project_name.wsgi
  

  替换your_project_name为你的Django项目实际名称。

2. 升级WSGI服务器版本 #

若使用gunicorn作为WSGI服务器，旧版本可能对Django的FileResponse支持不完善，执行升级：

pip install --upgrade gunicorn

更新requirements.txt后重新部署到Azure。

3. 检查并修正自定义代码 #

如果项目中有自定义中间件或响应处理逻辑，排查是否存在直接访问response.content的代码。对于FileResponse类型，需改用streaming_content，示例修正：

# 错误写法
content = response.content

# 正确写法
if hasattr(response, 'streaming_content'):
    content = b''.join(response.streaming_content)
else:
    content = response.content

4. 让Azure直接处理静态文件（最优方案） #

绕过Django，让Azure App Service直接托管静态文件，既提升性能也避免响应类型错误：

• Linux环境：
  在App Service的Configuration > Path mappings中添加映射规则：
  • 虚拟路径：/static/
  • 物理路径：/home/site/wwwroot/static
  • 类型选择Static
• Windows环境：
  修改web.config文件，添加静态文件处理规则，将/static/*请求指向项目根目录下的static文件夹。

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