Django生产环境静态文件不可见及django-el-pagination报404问题排查

看起来你已经做了基础配置，但生产环境的静态文件问题往往藏在细节里，我帮你梳理几个容易遗漏的排查方向：

• 确认静态文件是否被正确收集
  执行python manage.py collectstatic后，去你的STATIC_ROOT目录下检查，是否存在el_pagination文件夹，里面有没有需要的next.js（或相关JS文件）。部分第三方包的静态文件可能因安装方式、版本问题未被自动收集，手动验证路径是最直接的方式。

• 检查模板中静态文件的引用方式
  必须用Django的{% static %}标签来引用JS文件，比如：

  <script src="{% static 'el_pagination/js/next.js' %}"></script>
  

  别用硬编码的相对路径（比如/static/el_pagination/...），生产环境的STATIC_URL可能和开发环境不同，模板标签能保证路径自动适配。

• 验证生产服务器的静态文件映射配置
  如果你用Nginx或Apache，要确认服务器配置里把STATIC_URL对应的路径指向了STATIC_ROOT目录。比如Nginx需要类似这样的配置：

  location /static/ {
      alias /path/to/your/project/static_root/;
      expires 30d;
  }
  

  服务器没正确映射静态文件路径的话，哪怕文件存在也会返回404。

• 再核对settings.py的核心配置
  快速检查这几个参数：

  • INSTALLED_APPS里是否确实添加了'el_pagination'？有时候会出现拼写错误或复制遗漏的情况。
  • STATIC_URL是否和生产服务器配置的路径一致？比如服务器用/static_files/作为静态资源路径，那STATIC_URL也得同步设置。
  • STATIC_ROOT是否是collectstatic输出的正确路径，且服务器进程有读取该目录的权限？

• 清除浏览器缓存
  生产环境中浏览器可能缓存了旧的静态文件路径，哪怕你修复了配置，缓存也会导致404。可以用Ctrl+Shift+R强制刷新页面，或者用无痕模式测试。

如果以上都排查过还是有问题，去看生产服务器的访问日志（比如Nginx的access.log），里面会显示具体的404请求路径，对比静态文件实际存储路径，就能快速定位不匹配的地方。

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