Polly框架中ResilienceStrategy的无配置API优化

在构建弹性系统时，Polly框架提供了强大的策略模式来应对各种故障场景。近期社区针对AddStrategyAPI的设计提出了优化建议，旨在提升其在原生AOT和剪裁环境下的兼容性。

现有API的设计挑战

当前Polly框架中的AddStrategy扩展方法强制要求传入ResilienceStrategyOptions参数，这个设计带来了几个技术限制：

1. AOT兼容性问题：由于使用了DataAnnotations进行参数验证，这些API被标记为[RequiresUnreferencedCode]，导致它们无法很好地支持原生AOT编译场景。

2. 使用复杂度：即使开发者不需要任何配置选项，也必须创建一个空的选项类实例才能调用API，这增加了不必要的样板代码。

3. 警告抑制需求：在剪裁环境下使用这些API时，开发者需要手动抑制相关的警告提示。

解决方案设计

社区提出的优化方案是在现有API基础上增加一组新的重载方法，这些重载将：

• 移除强制性的options参数
• 保持相同的核心功能
• 完全兼容AOT和剪裁环境
• 简化不需要配置选项的使用场景

新的API签名将更加简洁，例如对于泛型构建器，将提供不包含options参数的重载版本。

技术实现考量

这种API设计改进体现了几个重要的软件设计原则：

1. 渐进式复杂度：为简单用例提供简单接口，同时保留复杂用例的支持能力。

2. AOT友好性：通过避免反射和动态验证，确保框架在现代部署场景下的适用性。

3. 向后兼容：现有代码不受影响，同时为新的开发提供更优选择。

实际应用价值

这一改进特别有利于：

• 开发不需要复杂配置的自定义策略
• 在移动应用和云原生环境中部署
• 需要极致性能的微服务场景
• 希望减少样板代码的开发者

总结

Polly框架通过这种API优化，进一步巩固了其在.NET弹性编程领域的领先地位。这种设计演进展示了开源社区如何持续改进API的可用性和适应性，特别是在新兴的AOT编译和剪裁环境中。对于需要构建高可靠性系统的开发者来说，这些改进将带来更简洁的代码和更广泛的部署选择。