解决Django生产环境无法加载静态文件问题的解决

时间:2022-06-06 03:39:10

起步

线上部署时因设置了 settings.debug = false 会导致静态文件都是 404 的情况。主要原因是应为关闭debug模式后,django 便不提供静态文件服务了。

runserver 的启动

如果运行是通过 runserver 命令的方式,那简单,在启动 runserver 指令后追加 --insecure 选项能参数强制 django 处理静态文件。

其他方式启动

但如果是通过 uwsgi 或 daphne 等启动的话,追加选项的方式就不管用了。要解决这个问题,我们要手动去使用静态文件服务,这种处理方式是比较推荐的,因为它同时也支持了 runserver 的方式。

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

?
1
2
3
4
5
6
7
8
9
10
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 函数的代码就立马理解了:

?
1
2
3
def serve(request, path, insecure=false, **kwargs):
  if not settings.debug and not insecure:
    raise http404

默认情况下 insecure=false ,并且在关闭调试模式后都是 404。通过写个 return_static 函数其实与 --insecure 的选项是异曲同工的。

媒体文件的处理

媒体文件的处理当然可以将上面 url 规则变动下就能加载了。如果用上面的方法来处理媒体文件可以得 90 分,那么下面的方法可以得 95 分。

上面的方法会搜索多个目录的,尽管开发人员会将静态文件同一放目录下。但 django 的 admin 模块的静态文件存放在其他地方的。

而媒体文件,我们只会限定在一个目录的,所以更好的处理方法是只在一个目录下搜索:

?
1
2
3
4
5
6
7
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 等。但显然我更希望是程序自身的处理方式。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://www.hongweipeng.com/index.php/archives/1745/