Django生产环境静态文件404问题解决方案

Django生产环境静态文件配置指南

起步

DEBUG=False导致静态文件404的原因

在线上部署Django应用时，若将settings.DEBUG设置为False，常会遇到静态文件全部返回404错误的现象。其根本原因在于，当DEBUG模式关闭后，Django默认不再提供静态文件的直接服务。

runserver启动时的解决方案

runserver 的启动

如果项目是通过runserver命令启动的，解决方法相对简单：只需在启动runserver指令后追加--insecure选项，即可强制Django继续处理静态文件请求。

uwsgi/daphne环境下的静态服务配置

其他方式启动

然而，若项目通过uwsgi或daphne等生产级服务器启动，上述追加选项的方式将失效。此时，推荐采用手动配置静态文件服务的方式来解决，该方法同样兼容runserver环境，且更具通用性。

通过URL路由解决静态文件加载

解决的方式如下，在 urls.py 中添加 url 规则：

from django.contrib.staticfiles.views import serve
from django.urls import re_path

def return_static(request, path, insecure=True, **kwargs):
  return serve(request, path, insecure, **kwargs)

urlpatterns = [
  ...
  re_path(r'^static/(?P<path>.*)$', return_static, name='static'), # 添加这行
]

这样就行了。

为什么这样就能解决了？

关键在于进行了静态文件的路由匹配，并引入了return_static函数来代理serve服务。通过查看serve函数的源码即可理解其原理：

def serve(request, path, insecure=False, **kwargs):
  if not settings.DEBUG and not insecure:
    raise Http404

默认情况下，serve函数的insecure参数为False，且在关闭调试模式后直接返回404。编写return_static函数并传入insecure=True，其效果与使用--insecure命令行选项异曲同工。

媒体文件的优化处理方案

媒体文件的处理

对于媒体文件，只需对上述URL规则稍作调整即可实现加载。若采用前述方法处理媒体文件，大致可得90分；而采用下文介绍的方法，则可提升至95分。

前述方法会搜索多个目录，尽管开发者通常将静态文件集中存放，但Django admin模块的静态文件可能位于其他目录中。

而媒体文件通常限定在单一目录下，因此更优的处理方式是仅在一个指定目录下进行搜索：

from django.views.static import serve as static_serve  # 注意这里引入的与上面的不同
from django.urls import re_path

urlpatterns = [
  ...
  re_path(r'^media/(?P<path>.*)$' , static_serve, { 'document_root' : settings.MEDIA_ROOT}),
]

另外，如果网站的所有静态文件均通过collectstatic命令合并至单一目录，建议同样使用static_serve方式处理静态文件，以追求程序的精益求精。

总结

此外，也可通过Nginx等第三方服务设置alias来处理静态文件，但本文更推荐应用层面的原生处理方式。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。