如何配置Wagtail 2.0.1为文档设置正确的MIME类型？

遇到PDF上传后返回application/octet-stream导致直接下载的问题确实挺头疼的——这个通用二进制类型完全不会触发浏览器的内置预览逻辑。下面给你两种实用的解决思路，不需要复杂插件就能搞定：

方法一：通过settings.py全局配置MIME类型映射 #

Wagtail基于Django运行，我们可以直接利用Django底层的MIME类型处理机制来覆盖默认值。在你的settings.py文件末尾添加这段代码：

import mimetypes

# 为PDF注册正确的浏览器预览MIME类型
mimetypes.add_type('application/pdf', '.pdf', strict=True)

# 如果还有其他需要预览的文档类型，比如Word/Excel，可继续添加
mimetypes.add_type('application/vnd.openxmlformats-officedocument.wordprocessingml.document', '.docx', strict=True)
mimetypes.add_type('application/vnd.ms-excel', '.xls', strict=True)

这段代码会在Django启动时替换默认的MIME类型映射，当Wagtail提供文档文件时，就会自动使用这些正确的类型，浏览器就能识别并触发内置预览了。

方法二：自定义Wagtail Document模型，手动控制响应头 #

如果全局配置不生效（可能是Wagtail的文档服务逻辑有特殊处理），可以自定义Document模型，覆盖它的serve方法来强制设置Content-Type：

1. 在你的项目app下创建/修改models.py，添加以下代码：

from wagtail.core.models import Document

class CustomPreviewDocument(Document):
    def serve(self, request):
        # 先调用父类的serve方法获取基础响应
        response = super().serve(request)
        # 根据文件扩展名匹配对应MIME类型
        file_ext = self.file.name.split('.')[-1].lower()
        mime_type_map = {
            'pdf': 'application/pdf',
            'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
            'pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
            # 按需添加更多类型
        }
        if file_ext in mime_type_map:
            response['Content-Type'] = mime_type_map[file_ext]
        return response

2. 在settings.py中指定Wagtail使用这个自定义模型：

WAGTAILDOCS_DOCUMENT_MODEL = '你的app名称.CustomPreviewDocument'

3. 最后运行迁移命令使修改生效：

python manage.py makemigrations
python manage.py migrate

这样无论是新上传还是已存在的文档，都会通过自定义模型的serve方法返回正确的Content-Type。

额外提示 #

因为你使用的是Wagtail 2.0.1这个较旧的版本，很多新插件可能存在兼容性问题，所以优先推荐上面两种原生解决方案。如果是全局配置的方式，现有文档不需要任何额外操作就能自动生效；自定义模型的话，现有文档会自动关联到新模型（Wagtail的文档模型替换逻辑比较平滑）。

内容的提问来源于stack exchange，提问作者Mike 'Pomax' Kamermans