Spring Framework中RestClient对泛型请求体参数的类型处理问题解析

问题背景

在Spring Framework 6.2.2版本中，开发者从FeignClient迁移到新的RestClient时发现了一个关于泛型类型处理的重要差异。当使用HTTP接口声明式客户端时，如果方法参数使用了泛型类型（如Set<MyType>），这些泛型信息在请求体序列化过程中会丢失，而在响应反序列化时却能正常保留。

技术细节分析

现象表现

考虑以下接口定义：

public interface MyInterface {
    @PostExchange("/mock-endpoint")
    void callMockEndpoint(@RequestBody Set<MyType> myTypeSet);
}

当通过RestClient生成代理实现时：

1. 请求阶段：Set<MyType>中的MyType类型信息丢失
2. 响应阶段：泛型类型信息能够正确保留

底层机制

通过分析源码发现：

1. HttpServiceMethod在创建ResponseFunction时能获取到方法参数的完整泛型信息
2. 但在后续处理中，请求体参数被转换为Object类型传递，而非使用ParameterizedTypeReference
3. RestClientAdapter最终调用的是RequestBodySpec.body(Object)方法，而不是支持泛型的<T> body(T, ParameterizedTypeReference<T>)重载

影响范围

此问题会导致：

1. 需要特定类型信息才能正确序列化的对象无法正常工作
2. 与FeignClient的行为不一致，影响迁移体验
3. 如果采用包装类方案解决，会污染领域模型设计

解决方案建议

虽然可以通过为泛型集合创建包装类来解决：

public class MyTypeSet {
    private Set<MyType> items;
    // getters/setters
}

但这种方案会带来额外复杂度，特别是在接口需要同时用于客户端和控制器实现时。

框架演进方向

根据Spring团队反馈，这很可能是一个实现上的疏忽而非设计决策。预期在后续版本中会修复此问题，使请求体和响应体的泛型处理保持一致。

最佳实践建议

对于当前版本的用户：

1. 对于简单类型，可以直接使用
2. 对于复杂泛型参数，暂时使用包装类方案
3. 关注框架更新，及时升级修复版本

该问题的解决将进一步完善Spring的声明式HTTP客户端能力，使其在类型处理方面达到与Feign同等的成熟度。