Flask需手动解析Range头并返回206响应：提取bytes范围，校验有效性，设置Content-Range；send_file在conditional=True且传入文件对象时可自动支持；大文件应使用流式Response生成器分块读取；反向代理常导致Range失效，需直连排查。
Flask 怎么解析 Range 请求头并返回部分内容
Flask 本身不自动处理 HTTP Range 请求，必须手动读取 Range 请求头、解析字节范围、构造 206 Partial Content 响应。核心是拿到 request.headers.get('Range')，再用正则或字符串切分提取起始和结束位置。
常见错误是直接用 range.split('-') 但没处理末尾无数字的情况（如 bytes=100-），或忽略单位不是 bytes 的非法值。实际只支持 bytes 单位，其他应返回 416 Range Not Satisfiable。
实操建议：
- 用
re.match(r'bytes=(\d+)-(\d+)?', range_header)安全提取，捕获组可为空 - 若结束位置缺失（
bytes=100-），需计算文件总大小后补全 - 起始位置必须 ≥ 0，且不能 ≥ 文件总大小；否则返回
416 - 响应必须设置
Content-Range头，格式为bytes {start}-{end}/{file_size}
如何用 send_file 支持断点续传
send_file 默认不识别 Range，但 Flask 2.2+ 的 send_file 在传入文件对象（而非路径）且设置了 conditional=True 时，会自动启用条件响应逻辑——包括处理 Range 和 If-Range。
立即学习“Python免费学习笔记（深入）”；
注意：这个自动逻辑仅对真实文件路径（pathlib.Path 或 str）无效，必须是打开的二进制文件对象（io.BytesIO 或 open(..., 'rb')），且 conditional=True 是关键开关。
实操建议：
- 不要传
filename字符串，改用open(filepath, 'rb')得到文件对象 - 显式加
conditional=True参数，否则自动 Range 支持不会触发 - 确保响应中包含
ETag或Last-Modified，否则conditional=True退化为普通响应 - 若用
BytesIO，需先调用.getvalue()或确保其支持seek()和read()
大文件场景下避免内存爆炸的流式处理方式
用 send_file 加 conditional=True 虽方便，但对超大文件（如 >1GB），Flask 仍可能因内部 seek/read 操作导致 I/O 阻塞或临时缓冲膨胀。更可控的方式是手动流式响应：用 Response + 生成器，按需读取指定范围块，每次只读几 KB。
关键点在于不一次性加载整个范围进内存，而是用 file.seek(start) 定位，循环 file.read(chunk_size) 直到读够 end - start + 1 字节。
实操建议：
- 用
yield生成器返回数据块，避免构建大 bytes 对象 - 设置
Content-Length为实际返回字节数（即end - start + 1），别用原始文件大小 - 务必在响应头中写入
Accept-Ranges: bytes，否则客户端可能不发 Range 请求 - 对 NFS 或网络存储，频繁
seek可能变慢，可考虑预读缓存首尾 64KB
前端请求没带 Range 或服务端返回 200 而非 206 怎么排查
最常见原因是 Nginx / Apache 等反向代理默认吞掉 Range 头或强制转成 200。例如 Nginx 默认关闭 underscores_in_headers 不影响，但若配置了 proxy_buffering on，就可能缓存整个响应并丢弃分块语义。
另一个隐蔽问题是 Flask 开发服务器（Werkzeug）在调试模式下不完全兼容部分 Range 边界情况（如 bytes=-100），而生产 WSGI 服务器（Gunicorn/Uvicorn）表现正常。
排查建议：
- 用
curl -v -H "Range: bytes=0-1023" http://localhost:5000/file直连 Flask，确认是否返回206 - 检查反代配置：Nginx 需开启
proxy_ignore_client_abort off，并确保未设置proxy_buffering on - 用浏览器开发者工具看 Network → Headers，确认请求发出的
Range和响应的Status、Content-Range是否匹配 - 服务端加日志：打印
request.headers.get('Range')和最终返回的状态码，定位拦截点
Range 处理真正的复杂点不在 Python 侧，而在中间件、CDN、客户端缓存策略的叠加效应。哪怕代码完全正确，一层 CDN 返回了带 200 的缓存，前端就永远收不到 206。上线前务必绕过所有代理直测，并检查每一层响应头的原始性。
