Django设置DEBUG=False时静态与媒体文件无法加载的求助

当把DEBUG设为False后，Django会关闭自带的静态文件服务，这就是你遇到加载问题的核心原因。下面给你两种可靠的解决方式：

方式一：用Web服务器托管（以Nginx为例） #

这是生产环境最常用的方案：

• 先确认python manage.py collectstatic已经把所有静态文件同步到STATIC_ROOT目录里了
• 打开Nginx的站点配置文件，添加静态文件的路由规则：

server {
    # 你的其他配置（比如反向代理到Django的uWSGI/Gunicorn）
    
    # 匹配静态文件请求
    location /static_files/ {
        alias /home/domain/public_html/static_cdn/static_root/;
        expires 30d;  # 开启浏览器缓存，提升加载速度
    }

    # 匹配媒体文件请求
    location /media_files/ {
        alias /home/domain/public_html/static_cdn/media_root/;
        expires 30d;
    }
}

• 重启Nginx生效：sudo systemctl restart nginx

方式二：用Whitenoise中间件（无需额外Web服务器配置） #

如果不想折腾Web服务器配置，可以用Whitenoise直接让Django处理静态文件：

1. 安装依赖：

pip install whitenoise

2. 修改settings.py：

# 更新INSTALLED_APPS，把whitenoise放在staticfiles前面
INSTALLED_APPS = [
    # 其他应用...
    'whitenoise.runserver_nostatic',
    'django.contrib.staticfiles',
]

# 更新MIDDLEWARE，把Whitenoise中间件放在SecurityMiddleware后面
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',
    # 其他中间件...
]

# 可选：开启静态文件压缩和缓存，优化性能
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

3. 重新执行collectstatic确保文件同步：

python manage.py collectstatic

必做检查项 #

• 权限：确保Web服务器进程（比如www-data）能读取static_cdn目录：

sudo chown -R www-data:www-data /home/domain/public_html/static_cdn/
sudo chmod -R 755 /home/domain/public_html/static_cdn/

• ALLOWED_HOSTS：生产环境必须配置你的域名或服务器IP，否则Django会拒绝请求：

ALLOWED_HOSTS = ['你的域名.com', '服务器IP地址']

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