Django设置DEBUG=False后CSS样式失效问题求助

1. 先执行静态文件收集命令 #

当DEBUG设为False后，Django不会自动托管静态文件，必须先把所有静态文件统一收集到指定目录：

python manage.py collectstatic

执行后检查STATIC_ROOT配置的目录下，是否存在template/style.css和images/EasyBuyIcon.png文件，确保没有报错。

2. 核对settings.py静态配置 #

确保settings里的静态相关配置正确：

STATIC_URL = '/static/'
# 必须是绝对路径，用来存放收集后的静态文件
STATIC_ROOT = os.path.join(BASE_DIR, 'collected_static')
# 如果项目根目录下的static是自定义静态目录，需要加入这个配置
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

注意：STATIC_ROOT不能和STATICFILES_DIRS里的路径重复，否则collectstatic会报错。

3. 配置Web服务器托管静态文件 #

DEBUG=False时，Django不处理静态请求，需要让Web服务器（如Nginx、Apache）接管：

• Nginx示例配置：

location /static/ {
    root /path/to/your/project/collected_static;
}

• Apache示例配置：

Alias /static/ /path/to/your/project/collected_static/
<Directory /path/to/your/project/collected_static>
    Require all granted
</Directory>

4. 验证模板路径与实际访问 #

查看页面源码，确认{% static 'template/style.css' %}生成的URL是/static/template/style.css，手动访问这个URL，如果返回404，说明路径映射或文件收集有问题。

5. 检查文件权限 #

确保Web服务器进程能读取静态文件目录：

chmod -R 755 /path/to/your/project/collected_static
chown -R www-data:www-data /path/to/your/project/collected_static

（www-data为常见服务器进程用户，根据你的服务器实际情况调整）

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