安装 brotli 库即可解决：执行 pip install brotli，Requests 会自动通过 urllib3 注册 br 解码器，无需改代码；若仍报错，需检查环境一致性、urllib3 版本是否 ≥1.26 或是否存在自定义适配器干扰解码流程。
Requests 报错 ContentEncodingError: Cannot decode content body 怎么办
这是 Requests 遇到 Brotli 压缩响应但没装解码支持时的典型报错。Requests 本身不内置 Brotli 解压能力，必须额外装库并确保底层 urllib3 能识别 br 编码。
- 不是所有服务器都用 Brotli，但越来越多 CDN（如 Cloudflare）默认启用，尤其对静态资源或 API 响应
- 报错通常出现在
response.text或response.json()调用时，而非response.content—— 因为后者不触发自动解码 - 别试
response.headers.get('content-encoding')后手动解压：urllib3 已尝试过且失败了，说明它根本没注册br解码器
装 brotli 还是 python-brotli？
只装 brotli（PyPI 上的 brotli 包）就足够，python-brotli 是旧名、已弃用，装了反而可能冲突。
- 执行
pip install brotli即可，不需要--upgrade或额外编译参数 - 装完后 Requests 会自动通过 urllib3 检测到
brotli模块，并注册br解码器——无需改代码、无需手动调用brotli.decompress() - 验证是否生效：运行
import urllib3; print(urllib3.util.response._DECODERS)，输出里应含'br'
为什么装了 brotli 还是报错？
常见原因不是库没装，而是环境或依赖链断了。
- 用了 conda 环境但用 pip 安装：conda 的 urllib3 可能没重新加载解码器，建议统一用
conda install -c conda-forge brotli - 项目锁了
urllib3 < 1.26：老版本 urllib3 不支持动态注册br解码器，必须升到1.26+（Requests 2.26+ 默认带） - 自己 patch 过
requests.adapters.HTTPAdapter或替换了urllib3.PoolManager：绕过了默认解码流程，得手动加decode_content=True或补解码逻辑 - 服务器返回的
Content-Encoding: br但实际内容不是合法 Brotli 流（比如被中间代理篡改），这时brotli.decompress()会抛BrotliError，需捕获处理
要不要手动解压？什么情况下必须绕过自动解码
绝大多数情况不用。但遇到以下场景，就得自己接管：
立即学习“Python免费学习笔记（深入）”；
- 响应头是
Content-Encoding: br，但 body 是空或极小（response.content +try/except更稳 - 需要复用解压后的 bytes 做多次解析（比如先
json.loads()再lxml.fromstring()），避免重复解压开销——直接brotli.decompress(response.content) - 用的是
httpx或aiohttp：它们不共享 Requests 的解码机制，httpx需要httpx[http2]（自带 Brotli 支持），aiohttp则要额外装aiohttp[br]
