直接用python -m http.server传大文件会卡顿或失败，因其默认单线程、不支持Range请求、无超时控制和断点续传，导致浏览器分片请求被忽略或返回404，连接中断或速度骤降。
为什么直接用 python -m http.server 传文件会卡顿或失败
局域网传大文件（比如 >100MB）时，http.server 默认行为容易触发浏览器下载中断、连接重置或传输速度骤降。根本原因不是协议问题，而是它默认不设超时、不处理并发请求、也不支持断点续传——浏览器发起多个 Range 请求时，服务端直接忽略或返回 404，客户端就卡住。
- Windows 资源管理器或 macOS Finder 通过 SMB 挂载访问更稳，但
http.server是纯 HTTP，没这些底层优化 - Python 3.7+ 的
http.server默认使用单线程，同一时间只能处理一个请求；手机浏览器预加载、多标签访问会排队甚至超时 - 不设置
Content-Length或错误设置Content-Range，会导致 Chrome/Firefox 拒绝接受分片响应
如何让 http.server 支持稳定的大文件下载
核心是绕过默认的 SimpleHTTPRequestHandler，自定义一个能正确响应 Range 请求、设置必要头字段、并启用线程池的版本。不需要额外依赖，纯标准库可实现。
- 继承
http.server.SimpleHTTPRequestHandler，重写do_GET方法，在读取文件前检查Range请求头 - 必须手动计算并返回
Content-Range和Content-Length，且状态码要设为206 Partial Content - 用
socketserver.ThreadingTCPServer替代默认单线程启动方式，避免请求阻塞 - 禁用日志输出（重写
log_message为空）可减少 I/O 开销，尤其在千兆局域网中明显提升吞吐
import socketserver
import http.server
import os
<p>class RangeRequestHandler(http.server.SimpleHTTPRequestHandler):
def do_GET(self):
if self.path == '/':
self.path = '/index.html'
f = self.send_head()
if f:
try:
self.copyfile(f, self.wfile)
finally:
f.close()</p><pre class="brush:php;toolbar:false;">def send_head(self):
path = self.translate_path(self.path)
if os.path.isdir(path):
return super().send_head()
if not os.path.exists(path):
self.send_error(404, "File not found")
return None
try:
f = open(path, 'rb')
except OSError:
self.send_error(403, "Forbidden")
return None
fs = os.fstat(f.fileno())
size = fs.st_size
start, end = 0, size - 1
range_header = self.headers.get('Range')
if range_header:
# 解析 Range: bytes=100-199
rstart, rend = range_header.strip().replace('bytes=', '').split('-')
start = int(rstart) if rstart else 0
end = int(rend) if rend else size - 1
self.send_response(206)
self.send_header('Content-Range', f'bytes {start}-{end}/{size}')
else:
self.send_response(200)
self.send_header('Content-Type', self.guess_type(path))
self.send_header('Content-Length', str(end - start + 1))
self.send_header('Accept-Ranges', 'bytes')
self.end_headers()
f.seek(start)
return f
if name == 'main': with socketserver.ThreadingTCPServer(('', 8000), RangeRequestHandler) as httpd: print("Serving at https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774") httpd.serve_forever()
实际使用时哪些路径和参数最容易出错
启动脚本后，本地浏览器能打开，但手机或另一台电脑访问不到，90% 是网络配置或路径权限问题，不是代码本身。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 绑定地址写成
localhost或127.0.0.1→ 必须用空字符串''或0.0.0.0才监听所有网卡 - 防火墙拦截：Windows Defender / macOS 防火墙默认阻止非签名 Python 进程监听外部连接，需手动放行端口 8000（TCP）
- 共享目录含中文或空格：Python 3.7+ 对 URL 解码基本可靠，但若用
urllib.parse.unquote手动处理路径，注意%20和+差异；建议启动前先os.chdir()到目标目录，避免路径拼接出错 - 手机访问显示 404：确认手机和电脑在同一子网（如都是 192.168.1.x），并在手机浏览器输完整 IP，例如
http://192.168.1.105:8000/file.zip，不要输localhost
比 http.server 更快的替代方案有哪些
如果只是临时传几个文件，http.server 加上上述改造已够用；但真要追求速度和稳定性，有三个轻量级替代方向值得留意：
-
python -m http.server --bind 0.0.0.0:8000 --directory ./share（Python 3.7+）→ 省去写脚本，但不支持 Range，仅适合小文件 - 用
aria2c --enable-rpc --rpc-listen-all搭配 Web UI，支持多线程下载、断点续传，但需额外安装 - 零配置方案：
pip install pyserv后运行pyserv --port 8000 --range，内部封装了线程+Range+跨域头，比手写更省心
真正影响体验的从来不是协议层，而是你有没有关掉 Windows 的“网络发现”自动限速、有没有把共享目录放在 SSD 上、以及手机 WiFi 是否启用了节电模式强制休眠链路——这些细节比选哪个模块更重要。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
