ureq 3.0 迁移指南：代理与证书配置变更解析

ureq 3.0 版本对代理和证书配置进行了重大改进，这些变更使库更加易用且功能更强大。本文将详细介绍这些变化及其对现有代码的影响。

代理配置变更

在 ureq 2.x 版本中，需要通过 proxy-from-env 特性标志来启用环境变量代理支持。而在 3.0 版本中，这一功能已成为默认行为，无需额外配置即可自动识别系统代理设置。

对于需要 SOCKS 代理的情况，仍然需要显式启用 socks-proxy 特性标志。这一设计决策使得基础代理功能开箱即用，同时保留了特殊代理类型的可选性。

证书验证机制改进

证书验证机制也经历了显著变化。2.x 版本中的 native-certs 特性标志已被移除，取而代之的是更灵活的 RootCerts 枚举系统。现在开发者可以通过 TlsConfig 在代理或请求级别指定证书验证策略：

1. Specific：手动指定根证书，适用于需要完全控制证书链的场景
2. PlatformVerifier：自动使用系统证书验证机制
   • 使用 rustls 后端时，会调用系统验证器
   • 使用 native-tls 后端时，会自动选择系统根证书
3. WebPki：使用 ureq 内置的根证书包

这种设计提供了更细粒度的控制，同时简化了常见用例的配置。

状态码处理优化

3.0 版本改进了状态码处理机制。ureq::OrAnyStatus 现在既可以通过代理配置全局设置，也可以通过 RequestBuilder 的配置方法针对单个请求设置。这种灵活性允许开发者在保持默认严格状态码检查的同时，在需要时轻松覆盖特定请求的行为。

迁移建议

对于从 2.x 迁移到 3.0 的项目：

1. 移除所有 proxy-from-env 特性标志的引用，因为其功能现在是默认启用的
2. 检查证书验证需求，选择合适的 RootCerts 策略
3. 评估状态码处理逻辑，考虑是否可以利用新的请求级配置能力

这些变更总体上简化了配置，同时提供了更强大的功能。理解这些变化将帮助开发者更顺利地完成迁移过程。