用途：安全升级 Oracle Cloud（OCI）的 Python SDK、OCI CLI 和 Terraform OCI provider，在升级前识别破坏性变更，并在失败时干净回滚。资料指出 OCI 的 Terraform provider 与 Python SDK 比 AWS 同类更常破坏向后兼容，例如 provider 升级后 terraform plan 崩溃、废弃资源类型被移除且无迁移路径、schema 变更静默改变行为，以及 SDK 小版本间认证类重命名、内存泄漏修复改变对象生命周期语义。
主要能力：审计当前 SDK、CLI、provider 版本；对照已知破坏性变更表评估影响（如 oci.retry 重构、validate_config 更严格、wait_for_state 废弃、oci_core_virtual_network 移除、provider 段错误等）；用版本约束升级 Python SDK 并验证 Identity、Compute、Network、Storage、Database、Monitoring 等核心客户端；用 required_providers 锁定 provider 版本并执行 terraform plan 检测意外替换；扫描废弃资源与 SDK 模式；提供 SDK、provider、Git 三级回滚。
使用方式：先运行 pip show oci、oci --version、terraform providers 等命令审计版本；备份 requirements 与 .terraform.lock.hcl；在独立分支中执行 pip install --upgrade "oci>=2.125.0,<2.130.0" 或 terraform init -upgrade；运行验证脚本与 terraform plan，检查 must be replaced、forces replacement、will be destroyed 等输出；异常时用备份文件或 git 分支回滚。
适用场景：升级 OCI 相关依赖、更新 Terraform provider、排查升级引入的认证或证书错误。限制：需 Python 3.8+、Terraform 1.5+、OCI CLI、Git 及测试环境，切勿直接在生产升级；具体版本兼容性与最新变更需以官方 changelog 为准。