Django使用iframe/embed展示PDF出现乱码无法正常显示问题求助

云原生阿岚

2026-9-30

你遇到的乱码是PDF源文件的二进制内容被浏览器识别为纯文本渲染导致的，核心原因是返回PDF的HTTP响应头Content-Type未设置为application/pdf，可按以下步骤排查解决：

1 动态返回PDF的视图配置

如果PDF是通过Django视图动态生成/返回的，修改视图代码，明确指定响应头：

from django.http import HttpResponse
from .models import Packet

def get_certificate_pdf(request, packet_id):
    # 业务逻辑，获取对应的packet对象
    packet = Packet.objects.get(id=packet_id)
    with open(packet.certificate_pdf.path, 'rb') as pdf_file:
        pdf_content = pdf_file.read()
    # 指定content_type为pdf类型
    response = HttpResponse(pdf_content, content_type='application/pdf')
    # inline参数指定浏览器直接预览，若要强制下载可改为attachment
    response['Content-Disposition'] = 'inline; filename="certificate.pdf"'
    return response

模板中embed/iframe的src属性改为对应视图的路由地址即可。

2 静态媒体文件的Web服务器配置

如果生产环境由Nginx/Apache直接Serve存储在媒体目录的PDF文件，需要配置服务器的MIME类型映射：

Nginx：在配置文件的http块或站点配置块中添加以下配置，重启Nginx生效
```
types {
    application/pdf  pdf;
}
```
Apache：在httpd.conf或站点根目录的.htaccess文件中添加：
```
AddType application/pdf .pdf
```