关闭Django DEBUG模式后，NGINX反向代理下静态文件部分加载异常求助

环境与配置信息 #

• 系统：Armbian Linux，Python 3.7.3
• Django项目目录结构：

/var/webserver/backend
├── manage.py
├── backend
│   └── settings.py
└── static
    ├── img（包含logo、favicon及收集的静态文件）
    └── admin（收集的后台静态文件）

• Nginx静态资源相关配置：

location /static {
    autoindex on;
    autoindex_exact_size off;
    alias /var/webserver/backend/static;
}

• Django settings.py 静态资源配置：

STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'static'

问题现象 #

• static/img下的logo.png、favicon.ico可正常显示
• 所有CSS、JS文件无法加载（页面无样式）
• Django和Nginx的access.log均无404错误，所有请求返回状态码200
• 直接访问页面检查器中的CSS/JS路径（如/static/admin/css/base.css）可正常查看文件内容
• 已尝试修改文件权限为777、所有者设为root:www-data，无效
• 安装WhiteNoise后问题依旧
• 已禁用浏览器缓存，排除缓存影响
• 尝试将Nginx配置中的alias改为root，问题更严重（图片也无法加载）

解决思路与方案 #

1. 检查Nginx MIME类型配置 #

CSS/JS返回200但无法加载，最常见原因是Nginx未正确设置MIME类型，导致浏览器无法识别文件格式。

• 打开Nginx主配置文件（通常为/etc/nginx/nginx.conf），确认包含以下配置：

include /etc/nginx/mime.types;
default_type application/octet-stream;

若缺失，添加后重启Nginx：systemctl restart nginx

• 也可在location /static块中临时指定MIME类型测试：

location /static {
    autoindex on;
    autoindex_exact_size off;
    alias /var/webserver/backend/static;
    types {
        text/css css;
        application/javascript js;
        image/png png;
        image/x-icon ico;
    }
}

2. 规范Django模板的静态资源引用方式 #

确保模板中使用Django官方的static模板标签引用资源，而非硬编码路径：

{% load static %}
<link rel="stylesheet" href="{% static 'admin/css/base.css' %}">

关闭DEBUG后，硬编码路径可能触发隐藏的路径解析问题，即使直接访问有效，模板渲染环节仍可能异常。

3. 完善Nginx反向代理的请求头传递 #

关闭DEBUG后，Django会严格校验请求头，Nginx反向代理时需正确传递必要头信息：
在Nginx的反向代理location块中添加：

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

同时更新Django settings.py：

ALLOWED_HOSTS = ['你的域名/IP地址']
USE_X_FORWARDED_HOST = True
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

4. 校验静态文件内容完整性 #

虽然直接访问能看到内容，仍需确认文件本身无异常：

• 用命令行查看本地文件内容：cat /var/webserver/backend/static/admin/css/base.css
• 对比直接访问该文件时的内容是否完全一致，排除文件被篡改或编码异常的可能

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