讲师中心 微信公众号
AI工具推荐 视频效率加速

怎样在Python中实现一个支持断点续传的HTTP文件下载器?

大墨姑娘_3250

大墨姑娘_3250

发布时间:2026-07-21 08:04:57

|

704人浏览过

|

来源于php中文网

原创

因为默认请求不带Range头,服务器返回完整文件而非部分内容,导致中断后必须重传且浪费带宽;需先查本地文件大小,发送Range: bytes=start-请求,用'ab'模式写入,并校验206状态码。

怎样在python中实现一个支持断点续传的http文件下载器?

为什么直接用 requests.get() 无法断点续传

因为默认请求不带 Range 头,服务器不会返回部分内容,而是从头开始发整个文件。即使你本地已下载一半,requests.get() 仍会重新拉取全部,浪费带宽且无法恢复中断。

真正支持断点续传,必须:主动检查本地文件长度 → 发送带 Range: bytes=<var>start</var>- 的请求 → 以 ab(追加写)模式写入文件。

  • 服务端需支持 Accept-Ranges: bytes(可用 curl -I <var>url</var> 查看响应头)
  • 若响应状态码不是 206 Partial Content,说明服务端不支持或拒绝范围请求
  • 注意:某些 CDN 或 Nginx 默认关闭 range 支持,需配置 enable_ranges on;

如何构造带 Range 的请求并安全写入文件

核心逻辑是先读取本地文件当前大小,作为下次请求的起始偏移;再用 requests.get(..., headers={'Range': f'bytes={file_size}-'}, stream=True) 获取剩余内容。

关键细节:

立即学习“Python免费学习笔记(深入)”;

  • 务必设 stream=True,否则 response.content 会加载全部响应体,失去流式续传意义
  • 打开文件必须用 open(..., 'ab') —— 不能用 'wb'(会清空),也不能用 'a'(文本模式写二进制会出错)
  • 检查 response.status_code:应为 206;若返回 200,说明服务端忽略 Range,需降级为全量重下或报错
  • 写入前建议校验 Content-Range 响应头,确认起始位置与预期一致(例如 bytes 1024-9999/10000)

怎么处理网络中断和重试逻辑

断点续传真正的难点不在首次请求,而在多次失败后的状态一致性:文件大小、已写位置、HTTP 连接异常都需要协同处理。

python全能编程助手
python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、

下载

实操建议:

  • 每次写入前,用 os.path.getsize() 动态获取当前文件大小,而不是依赖内存变量(防止中间被其他进程修改)
  • 对 requests.exceptions.ConnectionError、Timeout 等做指数退避重试(如 time.sleep(2 ** retry_count)),最多 3–5 次
  • 避免在重试循环里重复发送 HEAD 请求查总大小——它可能不准确(比如服务端动态生成文件),应以首次成功响应中的 Content-Length 或 Content-Range 为准
  • 下载完成前,可临时写入 .downloading 后缀,防止程序崩溃后残留不完整文件被误用

要不要用 urllib3 或 aiohttp 替代 requests

requests 完全够用,但要注意它底层 urllib3 对 Range 请求的支持是完整的;而 aiohttp 在异步场景下需手动管理 Range 和文件写入锁,复杂度陡增,除非你已有 asyncio 架构,否则没必要切换。

真正值得替换的情况只有一种:需要并发下载多个大文件且对内存敏感。此时可考虑 urllib3.PoolManager 复用连接,或用 httpx(支持同步/异步 + 自动 Range 探测)。

但多数场景下,老老实实用 requests + 显式 Range 头最稳——毕竟断点续传的核心不是并发能力,而是状态可控和错误可追溯。

最后提醒:别依赖第三方“断点续传库”,很多只是封装了 Range 请求,却没处理文件大小竞争、服务端不返回 Content-Range、或重定向后丢失 Range 头等真实坑点。自己控制每一步,才真正可控。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1571

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

3764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1589

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

21557

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2667

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2707

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1103

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.08.10

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn