Django项目中MP4媒体文件服务异常求助：206状态与MIME类型问题

我之前开发Django项目时也碰到过几乎一模一样的问题，折腾了好一会儿才搞定，结合Django的媒体服务机制，给你几个实用的排查和解决方向：

1. 先搞定MIME类型解析警告 #

控制台提示的「resource interpreted as document but transferred with mime type video/mp4」，核心原因是浏览器收到视频文件时，响应头告诉它这是个"文档"而非可播放的视频资源。解决办法是自定义媒体文件的响应头：

自定义MP4文件处理视图 #

在你的app里新建一个视图，专门处理MP4文件的请求，强制设置正确的响应头：

from django.http import FileResponse, Http404
import os
from django.conf import settings

def serve_mp4(request, path):
    full_path = os.path.join(settings.MEDIA_ROOT, path)
    # 校验文件存在且是MP4格式
    if not os.path.exists(full_path) or not full_path.lower().endswith('.mp4'):
        raise Http404("Requested file not found or invalid type")
    
    # 构建响应，指定正确的MIME类型
    response = FileResponse(open(full_path, 'rb'), content_type='video/mp4')
    # 关键：告诉浏览器这是可内嵌播放的视频，不是下载文件
    response['Content-Disposition'] = 'inline; filename="{}"'.format(os.path.basename(full_path))
    # 支持断点续传的范围请求
    response['Accept-Ranges'] = 'bytes'
    return response

更新路由配置 #

在项目的urls.py里，用这个自定义视图替换默认的媒体文件服务路由：

from django.conf import settings
from django.conf.urls.static import static
from .views import serve_mp4  # 导入刚才的视图

urlpatterns = [
    # 你的其他业务路由...
] + static(settings.MEDIA_URL, view=serve_mp4)

2. 处理206 Partial Content的缓存问题 #

206状态码本身是正常的（用于视频的断点续传），但「from disk cache」导致的异常，大概率是浏览器缓存了不符合播放要求的旧响应。你可以在刚才的自定义视图里加上缓存控制头，避免旧缓存干扰：

在serve_mp4视图的return response之前，添加：

# 禁止浏览器缓存（或者根据需求设置合理的缓存时长）
response['Cache-Control'] = 'no-cache, no-store, must-revalidate'
response['Pragma'] = 'no-cache'
response['Expires'] = '0'

3. 检查反向代理配置（如果用了Nginx/Apache） #

如果你的Django部署在反向代理后面（比如Nginx），可能是代理服务器覆盖了Django的响应头，或者没正确处理视频文件的范围请求：

Nginx配置调整 #

找到处理/media/的location块，确保配置如下：

location /media/ {
    alias /your/actual/media/path/;
    # 明确MP4的MIME类型
    types {
        video/mp4 mp4;
    }
    # 启用Nginx的MP4模块，支持断点续传
    mp4;
    # 强制设置inline的Content-Disposition
    add_header Content-Disposition "inline";
}

Apache配置调整 #

确保启用了mod_headers和mod_mime模块，然后在配置文件或.htaccess里添加：

AddType video/mp4 .mp4
Header set Content-Disposition "inline"
EnableSendfile On  # 优化静态文件传输，支持范围请求

4. 前端嵌入方式检查 #

最后确认前端是用<video>标签嵌入视频，而不是直接用链接或iframe，否则浏览器还是会把它当成文档解析：

<video controls width="600">
    <source src="{{ MEDIA_URL }}videos/your-video.mp4" type="video/mp4">
    Your browser does not support HTML5 video.
</video>

按这个流程一步步排查，应该就能同时解决MIME类型警告和缓存导致的视频播放异常了。

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