生产环境禁用 pip install --upgrade pip，因其破坏镜像确定性、导致依赖解析不一致且不可回滚；pip 版本应由基础镜像或构建阶段显式锁定，升级须带精确版本、限构建阶段、并立即验证。
pip install --upgrade pip 在生产环境里不是“升级”，是埋雷。
它会直接污染运行时环境，破坏镜像确定性，且无法回滚。生产环境必须拒绝任何未经声明、未被锁定、非幂等的安装行为。
为什么 pip install --upgrade pip 会破坏生产镜像一致性
生产镜像（如 Docker）依赖 requirements.txt 或 poetry.lock 实现可复现构建。而 pip install --upgrade pip 是一个无输入、无锁、无校验的突变操作：
- 它不读取任何清单文件，不验证当前 pip 版本是否在允许范围内
- 它会覆盖容器内已预装的 pip（比如系统镜像自带的 pip 23.3），升级到最新版（如 25.1），而新版 pip 可能默认禁用旧协议（如
--find-links不带--trusted-host会静默失败） - 升级过程可能触发 wheel 缓存重建或元数据重写，导致后续
pip install -r requirements.txt行为不可预测（例如跳过某些包、误判依赖冲突） - 同一份 Dockerfile 在不同时间构建，可能因 pip 版本差异导致最终安装的间接依赖版本不一致（如
requests拉到的urllib3小版本不同）
pip 版本该由谁控制？
生产环境中，pip 本身是工具链一环，不是业务依赖——它的版本应由基础镜像或构建阶段显式声明，而非运行时动态变更：
- Docker 构建时用
FROM python:3.11-slim，就继承了该镜像预装的 pip 版本；若需指定，应在RUN阶段用python -m pip install --upgrade pip==24.3.1（带精确版本），并固定在 Dockerfile 中 - CI/CD 流水线中，禁止在部署脚本里调用
pip install --upgrade pip；所有工具版本应通过.python-version+pyenv或setup-pythonaction 统一管理 - 若使用
pip-sync，它对 pip 版本有最低要求（如 ≥22.0），但不会主动升级——不满足时应提前在基础层修复，而非让pip-sync运行时自行升级
升级 pip 的唯一安全路径：只在构建阶段，且带版本锁
真正需要更新 pip 时，必须满足三个条件：明确原因、限定范围、可审计。
百度文档解析pipeline-parser
下载
调用百度文档解析API，支持18+格式，提取文本、表格、版面分析、OCR识别及RAG文档分块。适用于文档解析、文本/表格提取、结构分析、扫描件处理。触发词：文档解析、PDF解析、Word解析、表格提取、OCR、文档分析、提取文本、文档结构、扫描识别。
- 原因只能是「当前 pip 无法解析 pyproject.toml」或「TLS 协议不兼容导致 pip install 失败」，而不是“提示 Consider upgrading pip”这种提示性警告
- 命令必须带具体版本：
python -m pip install --upgrade pip==24.3.1，不能省略==；避免用pip install --user或sudo pip，它们绕过容器隔离 - 升级后必须立即验证：
python -m pip --version（注意不是pip --version，防止 PATH 残留旧二进制） - 如果是在 Alpine 等精简镜像中发现
No module named pip，应走python -m ensurepip --upgrade --default-pip，再立刻锁 pip 版本，而非依赖 ensurepip 默认装的保守版
最容易被忽略的点：pip 升级会改变依赖解析逻辑
pip 22.x 开始默认启用 fast-deps，24.x 后默认禁用 legacy-resolver。这些变更会让同一份 requirements.in 经 pip-compile 输出不同的 requirements.txt。更隐蔽的是：旧版 pip 可能容忍某条不合法的依赖声明（如循环引用），而新版直接报错中断构建——你看到的不是“升级成功”，而是 CI 突然挂掉，且错误堆栈里根本找不到 pip 相关线索。
立即学习“Python免费学习笔记（深入）”；
