应启用stream=True流式下载,配合iter_content分块写入磁盘;不加该参数会将整个PDF加载进内存,易致MemoryError。需校验状态码、Content-Type或PDF魔数,处理重定向与文件名乱码,并显式调用response.close()释放连接。

requests.get() 默认会把整个PDF加载进内存,别这么干
PDF 文件动辄几 MB 甚至上百 MB,用 requests.get(url).content 一次性读取,容易触发 MemoryError 或拖慢程序。真正安全的做法是启用流式下载(stream=True),配合 iter_content() 分块写入文件。
关键点在于:不加 stream=True,response 对象会在调用 .content 或 .text 时自动把全部响应体载入内存;加了之后,才允许你手动控制读取节奏。
-
requests.get(url, stream=True)是必须的起点 - 后续必须用
response.iter_content(chunk_size=8192)迭代读取,不能直接 .content - 打开本地文件时务必用
"wb"模式(二进制写),PDF 不是文本
怎么处理重定向和 Content-Type 不匹配的问题
有些 PDF 链接实际是跳转页(比如带 token 的临时 URL),requests 默认会跟随重定向,但最终响应头里的 Content-Type 可能是 text/html(说明跳转失败或被拦截),而你却照常保存成 PDF,结果得到一个 HTML 文件。
建议在写入前加一层校验:
- 检查
response.status_code == 200 - 检查
response.headers.get("Content-Type", "").lower().startswith("application/pdf"),或至少包含"pdf" - 更稳妥的做法:用
response.content[:4] == b"%PDF"判断开头是否为 PDF 签名(魔数)
如何避免中文文件名乱码或非法字符报错
从 Content-Disposition 头里提取文件名时,常见问题包括:filename*=UTF-8''xxx.pdf 编码未解码、空格/斜杠/冒号等非法字符、路径过长。不要直接拼接使用。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
推荐做法是先尝试解析 Content-Disposition,失败则 fallback 到 URL 最后一段:
- 用
email.utils.decode_rfc2231()或第三方库urllib.parse.unquote()处理filename*字段 - 用
re.sub(r'[\/*?:"|]', "_", filename)替换 Windows 不允许的字符 - 确保保存路径存在:用
os.makedirs(os.path.dirname(save_path), exist_ok=True) - 如果 URL 末尾没有
.pdf,但响应确实是 PDF,强制补上扩展名
流式下载中 chunk_size 设多少合适
chunk_size 不是越大越好,也不是越小越稳。默认 iter_content() 是 chunk_size=1(字节级),效率极低;设太大(如 1024*1024)可能让小文件反而多一次系统调用。
实测下来,8192(8KB)是个平衡点:
- 对大多数网络环境和 PDF 大小都够用
- 内存占用可控(单次最多 8KB)
- 比默认值快一个数量级,又不会像 1MB 那样在小文件场景下浪费
- 注意:这个值只是建议缓冲区大小,不是硬性分块边界,底层 TCP 包仍由系统决定
真正容易被忽略的是:下载完成后记得显式关闭 response,尤其在循环批量下载时——response.close() 能及时释放连接池资源,否则可能触发 ConnectionPoolSizeError 或端口耗尽。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










