所有权升级前的风险核查

所有权升级前的风险核查

Rust 依赖升级后，编译通过只是起点。类型签名仍然兼容，不代表所有权行为、分配次数和异步取消语义没有变化。一个 API 如果从接收借用改为接收拥有值，调用方可能为了适配而加入 clone()；如果返回类型改成内部共享对象，资源释放时间也可能跟着改变。这些问题未必让测试立刻失败，却会留在热点路径里。

我会先限制升级范围，只更新目标包：

cargo update -p crate_name && cargo test --workspace

实际执行前要确认项目允许更新的版本区间。命令跑完后先看 Cargo.lock，检查目标包以外为什么发生变化。间接依赖确实可能一起更新，但每一项都应能由依赖关系解释，不能因为锁文件太长就整份略过。

从公开接口找所有权变化

变更日志给出方向，最终还要对比当前项目用到的接口。重点看参数是 &T、T 还是 Cow，返回值是否增加生命周期约束，回调是否要求 Send + 'static，错误类型里有没有新增分支。调用处为了消除编译错误所做的改动应单独审阅，尤其是新加的 clone、Arc、Box::leak 和扩大锁作用域。

这里不预设某种改动一定更慢。小对象复制可能没有实际影响，共享引用也可能增加原子计数开销。先从代码差异判断可能受影响的位置，再用测量确认，而不是看到 clone 就直接下结论。

生命周期变化要走完整失败路径

测试除了正常返回，还要覆盖提前 return、超时、取消和 panic 边界。升级后的库如果改变了 Future 被丢弃时的清理方式，连接、锁或临时资源可能活得更久。带后台线程或运行时句柄的依赖，还应验证服务关闭后进程能否退出，不能只看请求测试通过。

错误传播也值得单独核对。新增错误类型是否被上层归到正确类别，原有的可重试错误有没有变成通用失败，日志是否意外输出了底层敏感信息。若项目对错误做了穷举匹配，编译器会提示一部分变化；使用通配分支时，就需要测试补上缺口。

性能比较只回答明确问题

如果怀疑多了一次复制，我会选择能触发该路径的固定输入，分别运行旧版和新版，并记录构建模式、工具链和机器状态。需要观察的是分配、峰值内存或该调用段的耗时，而不是拿一次完整服务请求的总耗时猜测。差异没有超出测量波动时，就记录“当前条件下没有明确变化”。

升级前还要保留上一版可构建的锁文件和制品，写清回退后数据与协议是否兼容。纯库依赖通常可以直接回退，但如果新版改变了存储格式或网络交互，代码回退不一定能恢复原状态。这类变更应先在隔离环境验证旧版本能否读取新版本产生的数据。

最后再审阅一次 Cargo.lock、编译警告、完整测试和受影响路径的基准。核查的目的不是证明新版本“更先进”，而是确认我们知道它改变了什么、失败时停在哪里，以及出现问题后是否真的退得回去。