Spring Framework中WebClient重试机制与观测注册表的兼容性问题分析

问题背景

在Spring Framework的最新版本中，开发人员发现了一个关于WebClient重试机制与观测(Observation)功能交互时的兼容性问题。当开发者同时使用WebClient的重试功能和观测注册表(ObservationRegistry)时，系统会抛出InvalidObservationException异常，提示"Observation 'http.client.requests' has already been started"。

问题现象

具体表现为：在使用WebClient进行HTTP请求并启用重试机制(retry)时，如果同时配置了观测注册表(特别是TestObservationRegistry)，在Spring Boot 3.4.4版本中会抛出异常，而在之前的3.3.10版本中则能正常工作。

技术原理分析

这个问题源于Micrometer 1.14.0版本引入的ObservationValidator机制。该验证器会严格检查观测的生命周期，确保每个观测都有正确的开始和结束。在WebClient的重试场景中，当请求失败并触发重试时，系统会尝试重新开始相同的观测，而验证器检测到前一个观测尚未正确结束，因此抛出异常。

影响范围

此问题主要影响以下组合使用场景：

1. 使用Spring WebFlux的WebClient
2. 启用了重试机制(retry操作符)
3. 配置了观测功能(特别是TestObservationRegistry)
4. 运行在Spring Boot 3.4.4或相关版本

解决方案

Spring团队已经确认并修复了这个问题，修复将包含在即将发布的6.2.x维护版本中。对于当前遇到此问题的开发者，可以考虑以下临时解决方案：

1. 暂时降级到Spring Boot 3.3.10版本
2. 在测试环境中不使用TestObservationRegistry
3. 自定义ObservationRegistry实现，放宽生命周期验证

最佳实践建议

对于需要同时使用重试和观测功能的场景，建议：

1. 确保观测上下文能够正确处理重试场景
2. 在观测记录中包含重试次数等关键指标
3. 等待官方修复版本发布后及时升级
4. 在测试中验证观测数据是否包含预期的重试信息

总结

这个问题展示了在分布式系统观测中处理重试机制时的复杂性。观测系统需要能够识别并正确处理请求重试的场景，同时保持观测数据的准确性和一致性。Spring团队已经意识到这个问题并提供了修复方案，体现了框架对可观测性支持的持续改进。