collectstatic后404主因是STATIC_ROOT与STATICFILES_DIRS路径重叠导致未复制文件，应设STATIC_ROOT为独立目录如"staticfiles"；Nginx需用alias而非root映射/static/，并检查权限、日志及路径准确性。
collectstatic 执行后仍 404，先检查 STATIC_ROOT 是否被误设为 STATICFILES_DIRS
很多人把 STATIC_ROOT 和 STATICFILES_DIRS 搞混，导致 collectstatic 实际没拷贝任何文件。前者是「最终输出目录」，必须是绝对路径且不能和后者重叠；后者是「额外源目录列表」，用于收集非 app 内的静态资源。
常见错误写法：
STATICFILES_DIRS = [BASE_DIR / "static"] STATIC_ROOT = BASE_DIR / "static" <-- 错！这会让 collectstatic 跳过复制（源目标相同）
正确做法：
-
STATIC_ROOT应指向独立目录，例如BASE_DIR / "staticfiles" -
STATICFILES_DIRS保留原"static"，供开发时runserver查找 - 执行前确认
DEBUG=False，否则collectstatic可能跳过部分逻辑
Nginx 配置里 alias 和 root 混用导致路径错位
404 往往不是 Django 的问题，而是 Nginx 根本没找到文件。关键在 location /static/ 块中用 alias 还是 root —— 它们对 URI 到磁盘路径的映射逻辑完全不同。
立即学习“Python免费学习笔记（深入）”；
假设你设了 STATIC_ROOT = "/var/www/myapp/staticfiles"，那么：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 用
alias /var/www/myapp/staticfiles/;→ 请求/static/css/app.css映射到/var/www/myapp/staticfiles/css/app.css - 用
root /var/www/myapp/staticfiles;→ 同样请求会映射到/var/www/myapp/staticfiles/static/css/app.css（多了一层static）→ 404
务必用 alias，且末尾带斜杠；同时确保该路径下真实存在文件（可手动 ls -l /var/www/myapp/staticfiles/css/ 验证）。
collectstatic 不报错但实际没生成文件？检查 INSTALLED_APPS 和 finders
collectstatic 默认只收集 INSTALLED_APPS 下的 static/ 目录 + STATICFILES_DIRS，不会递归扫描子目录，也不会处理未声明的 app。
容易漏掉的点：
- 自定义 app 没加进
INSTALLED_APPS，它的static/就被忽略 - 用了第三方库（如
django-widget-tweaks），但没确认它是否自带静态文件、是否需额外配置STATICFILES_FINDERS - 执行命令时没加
--clear，旧文件残留干扰判断（尤其调试阶段） - 权限问题：Nginx 用户（如
www-data）无法读取STATIC_ROOT目录 → 返回 403 或 404（取决于系统配置）
Django 模板里 {% static %} 生成的 URL 正确，但 Nginx 日志显示 404
说明 Django 渲染没问题，问题一定出在 Nginx 到磁盘这一环。此时直接查 Nginx error log（不是 access log）最有效：
tail -f /var/log/nginx/error.log
典型报错：
-
open() "/var/www/myapp/staticfiles/css/app.css" failed (13: Permission denied)→ 改目录权限：chmod -R 755 /var/www/myapp/staticfiles，并确认属组是 Nginx 运行用户 -
no such file or directory→ 检查路径拼写，注意大小写（Linux 区分）、软链接是否断开、是否遗漏collectstatic步骤 - 日志里出现
rewrite or internal redirection cycle→ 多半是location块嵌套或正则冲突，简化配置先排除干扰
别依赖浏览器缓存，用 curl -I http://yoursite/static/css/app.css 看真实响应头和状态码。
