EC2部署Django项目admin后台静态文件404问题排查

安全阿岳

2026-8-26

问题原因

你的配置存在4处明确错误，是静态文件加载失败的核心原因：

Django配置语法错误：配置项debug=False为小写，Django仅识别全大写的DEBUG配置项，小写写法不会被框架读取，属于无效配置。
STATIC_ROOT路径配置错误：根据你的目录结构，BASE_DIR实际指向manage.py所在的my_project/admin/admin/目录，你配置的os.path.join(BASE_DIR,'my_project/static')会拼接出不存在的路径my_project/admin/admin/my_project/static，和你实际存放静态文件的my_project/admin/admin/static路径完全不匹配。
STATICFILES_DIRS配置逻辑错误：该参数用于指定collectstatic命令需要扫描的额外静态文件源目录，你将作为收集目标目录的STATIC_ROOT填入其中，会导致collectstatic出现逻辑冲突，无法正确将admin等app的静态资源拷贝到目标目录。
Nginx静态路径映射错误：你在Nginx配置中写的alias /static/指向服务器系统根目录下的static文件夹，和Django collectstatic实际输出静态文件的路径完全不一致，Nginx无法找到对应资源返回404。

修复步骤

按以下顺序修改配置即可解决问题：

修正settings.py静态相关配置

# settings.py
DEBUG = False

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_URL = '/static/'
# 指向manage.py同级的static目录，和你现有目录结构匹配
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

# 无额外自定义全局静态目录时留空即可，禁止将STATIC_ROOT加入该列表
STATICFILES_DIRS = []

修正Nginx配置中的静态路径映射
先确认STATIC_ROOT对应的服务器绝对路径（例如你的项目部署在/home/devel/目录下，绝对路径就是/home/devel/my_project/admin/admin/static/），替换原有静态location配置：

location /static/ {
    # 替换为你服务器上STATIC_ROOT的实际绝对路径
    alias /home/devel/my_project/admin/admin/static/;
    expires 30d; # 可选，配置静态文件缓存提升加载速度
}

注意location /static/和alias路径末尾都要加斜杠，避免路径拼接错误。
3. 重新收集静态文件并重载服务

进入manage.py所在目录，激活项目虚拟环境（如果使用虚拟环境），执行python manage.py collectstatic --noinput，执行完成后进入STATIC_ROOT目录，确认存在admin、css、js等子目录，说明admin后台静态资源已被正确收集。
执行nginx -t检查Nginx配置语法，返回successful后执行systemctl reload nginx重载配置。
执行chmod -R 755 /home/devel/my_project/admin/admin/static给静态文件目录添加可读权限，避免Nginx因权限不足返回403。

完成以上操作后强制刷新浏览器缓存，admin后台的样式和脚本即可正常加载。

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