Django模拟生产环境时静态资源（CSS/JS）无法加载的解决方案

当Django的DEBUG设为False时，开发服务器不再自动处理静态资源，这是引发问题的核心原因。以下是具体解决步骤：

1. 完成静态资源收集 #

首先要将所有App的静态文件集中到统一目录：

• 在base.py或prod.py中配置STATIC_ROOT，指定收集后静态文件的存放路径：

  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  

• 执行收集命令（替换为你的生产配置路径）：

  python manage.py collectstatic --settings=your_project.settings.prod
  

  执行后检查staticfiles目录，确认所有静态资源已被正确收集。

2. 配置静态资源的服务方式 #

Django本身不适合在生产环境直接处理静态资源，推荐用Web服务器代理或CDN，临时测试可使用Django内置视图（仅用于测试）。

方式一：Nginx代理（生产环境推荐） #

在Nginx配置文件中添加静态资源路由规则，指向STATIC_ROOT路径：

server {
    # 其他站点配置...
    location /static/ {
        root /path/to/your/project/staticfiles;
        expires 30d; # 设置缓存有效期
    }
}

重启Nginx生效，确保Nginx拥有staticfiles目录的访问权限。

方式二：临时用Django处理（仅测试） #

• 在prod.py中确认STATIC_URL配置：

  STATIC_URL = '/static/'
  

• 在项目根urls.py中添加静态资源路由：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 你的业务路由...
  ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
  

  注意：该方式性能差，生产环境禁止使用。

3. 检查Web服务器MIME类型配置 #

若Web服务器（如Nginx）的MIME类型配置缺失，会导致浏览器识别资源错误：

• 确保Nginx主配置中已加载默认MIME类型文件：

  include /etc/nginx/mime.types;
  

• 若特殊文件类型未被识别，可手动补充：

  types {
      text/css css;
      application/javascript js;
  }
  

4. 清除浏览器缓存 #

浏览器缓存的旧资源响应头可能引发MIME类型不匹配，按Ctrl+Shift+R强制刷新页面，或直接清除浏览器缓存后重新测试。

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