直接用 response.content 以 'wb' 模式写入文件即可保存为 pdf;需校验 status_code == 200、content-type 和前4字节是否为 b'%pdf';大文件应使用 stream=true 配合 iter_content() 流式下载。

requests.get() 返回的 content 怎么保存为 PDF 文件
直接用 response.content 写入二进制文件即可,PDF 是二进制格式,不能用 response.text 或编码转换。常见错误是当成文本写入,结果生成乱码或打不开的“PDF”。
- 务必以
'wb'模式打开文件(不是'w') -
response.content是原始字节流,原样写入最安全 - 如果 URL 重定向了,确保
requests.get(..., allow_redirects=True)(默认开启,但显式写上更稳妥) - 检查
response.status_code == 200再保存,避免把 404 页面 HTML 当 PDF 存下来
import requests
r = requests.get('https://example.com/doc.pdf')
if r.status_code == 200:
with open('output.pdf', 'wb') as f:
f.write(r.content)
怎么判断响应确实是 PDF 而不是网页或错误页
光看 URL 后缀不保险,有些服务返回 PDF 但 URL 是 /download?id=123;有些则伪装成 PDF 实际返回 HTML 登录页。靠 Content-Type 和文件头双重验证更可靠。
- 检查
r.headers.get('content-type')是否包含'application/pdf'(注意大小写不敏感) - 读取前 4 字节:PDF 文件固定以
%PDF开头,可用r.content[:4] == b'%PDF'快速校验 - 若两者都不满足,大概率不是 PDF,建议打印
r.url和r.status_code排查重定向或登录跳转
大 PDF 文件下载中断怎么办:用 stream=True 配合 iter_content
直接 .content 会把整个文件加载进内存,几百 MB 的 PDF 容易 OOM;且无法处理网络中断。用流式下载能控内存、支持断点续传逻辑。
- 必须加
stream=True参数,否则iter_content()没意义 -
iter_content(chunk_size=8192)每次读 8KB,适合大多数场景;太小增加 I/O 次数,太大占内存 - 写入时用
'ab'(追加二进制)可模拟断点续传,但需自己管理已下载字节数和Range请求头
r = requests.get('https://big-file.pdf', stream=True)
with open('large.pdf', 'wb') as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk: # 过滤 keep-alive 空块
f.write(chunk)
为什么保存后 PDF 打不开:常见陷阱汇总
不是代码写错,而是环境或服务端行为导致——这些点容易被忽略,但一踩就卡半天。
- 目标网站反爬:返回 200 但内容是 JavaScript 渲染页或验证码 HTML,
content[:4]不是b'%PDF' - 请求头缺失:部分 PDF 接口校验
User-Agent或Referer,不带可能返回 403 或空白响应 - HTTPS 证书问题:内网或自签证书环境,
requests默认校验失败,需加verify=False(仅测试用,生产应配证书路径) - 压缩传输:响应头含
Content-Encoding: gzip,但requests默认自动解压,此时.content已是解压后数据,无需手动gzip.decompress()
真正麻烦的是那些没报错、保存成功、但双击打不开的 PDF——往往得倒回去看 response.content[:16] 和 response.headers 才能找到线索。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











