配置MediaCling实现视频进度跳转后Django站点返回404错误如何解决

问题根源 #

全局纯文本404问题由两个常见配置错误导致：

1. MEDIA_URL配置为根路径：如果settings.py中MEDIA_URL = '/'，MediaCling会拦截所有路径的请求，优先到MEDIA_ROOT目录下查找对应文件，找不到直接返回纯文本404，不会将请求转发给内层Django应用处理动态页面。
2. 静态资源处理层包装顺序错误：当前的顺序是先包Cling再包MediaCling，会导致静态资源请求被MediaCling额外校验，部分版本的dj-static会因此出现路径匹配逻辑异常。

修复步骤 #

第一步：调整settings.py配置 #

将MEDIA_URL修改为专属前缀，避免拦截全局请求，示例配置：

# settings.py
MEDIA_URL = '/media/'
# 指向你存储影片的本地目录
MEDIA_ROOT = os.path.join(BASE_DIR, 'movies')

第二步：修正wsgi.py的包装顺序 #

调整MediaCling和Cling的顺序，确保请求匹配优先级正确，修改后代码如下：

import os

from django.core.wsgi import get_wsgi_application
from dj_static import Cling, MediaCling
from static_ranges import Ranges

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'Movies_site.settings')

# 优先级：先处理媒体文件，再处理静态文件，最后交给Django处理动态请求
application = Ranges(MediaCling(Cling(get_wsgi_application())))

第三步：校验额外配置项 #

• 确保ALLOWED_HOSTS配置包含你访问站点用的IP或域名
• 确认Django运行进程有MEDIA_ROOT目录的读取权限
• 私人小流量场景可使用该方案，高并发生产环境建议用Nginx处理静态/媒体资源

内容的提问来源于stack exchange，提问作者David Félix