生产环境出现 StaticFilesNotFound，通常是因为 Django 关闭了调试模式后不再自动托管静态文件，需要手动收集并通过 Nginx 等服务器对外提供。

命令速用版

如果你已经配置好 Nginx 或 Apache，通常只需执行以下命令收集静态文件：

python manage.py collectstatic `--noinput`

若未配置 Web 服务器托管，临时验证可开启 DEBUG 测试，但生产环境严禁此举。

为什么会这样

Django 在开发模式（DEBUG=True）下会自动处理静态文件请求，方便调试。一旦进入生产环境（DEBUG=False），为了性能和安全，Django 默认不再处理这些请求。此时如果没有任何外部服务器（如 Nginx）指向收集后的静态目录，用户请求 CSS、JS 或图片时就会返回 404 错误。

分步处理

1. 检查 settings.py 配置
确认项目中已定义 STATIC_ROOT 路径，该目录用于存放收集后的静态文件。注意 BASE_DIR 类型，推荐使用 os.path 兼容旧版本：

import os
STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")

2. 执行收集命令
在服务器项目根目录下运行收集命令，将各 app 及 STATICFILES_DIRS 中的文件复制到 STATIC_ROOT：

python manage.py collectstatic `--noinput`

3. 配置 Web 服务器
以 Nginx 为例，需在配置文件中添加 location 块，将静态 URL 映射到物理路径。注意必须使用绝对路径：

location /static/ {
    alias /home/username/project/staticfiles/;
}

注意 alias 路径末尾的斜杠与 location 末尾斜杠的对应关系，避免路径拼接错误。

4. 修正文件权限
collectstatic 生成的文件所属用户可能与 Web 服务器运行用户不一致，导致 403 禁止访问。建议修改所有者：

chown -R www-data:www-data /home/username/project/staticfiles/

5. 重启服务
配置完成后重载 Nginx 配置并重启 Django 应用（如 Gunicorn/uWSGI）：

sudo systemctl reload nginx

怎么验证是否生效

1. 浏览器检查
打开页面按 F12 进入开发者工具，查看 Network 标签，刷新页面，确认静态资源状态码为 200 而非 404。

2. 命令行测试
使用 curl 直接请求静态文件 URL，确认能返回文件内容：

curl -I https://your-domain.com/static/css/style.css

3. 日志观察
查看 Nginx 错误日志，确认不再有针对静态文件的路径错误记录。

可选方案：WhiteNoise 中间件

如果不想配置 Nginx 托管静态文件，可以使用 WhiteNoise 中间件让 Django 直接处理静态文件。适合 PaaS 部署或简单场景：

pip install whitenoise

在 settings.py 中间件列表中加入：

MIDDLEWARE = [
    # ...
    "whitenoise.middleware.WhiteNoiseMiddleware",
]

常见坑

1. 权限问题：collectstatic 生成的文件所属用户可能与 Web 服务器运行用户不一致，导致 403 禁止访问，需检查文件读写权限。

2. 路径混淆：STATIC_ROOT 是收集目标目录，不应手动放入源文件；源文件应放在各 app 的 static 目录或 STATICFILES_DIRS 中。

3. 缓存干扰：修改静态文件后，浏览器可能缓存旧版本，导致看似未生效，可尝试强制刷新或配置文件版本哈希。

4. 错误使用 DEBUG：切勿为解决此问题在生产环境将 DEBUG 设为 True，这会暴露敏感信息并严重影响性能。