Spring Boot 2.6.7 自定义依赖嵌套泛型Bean无法找到问题排查

核心结论 #

这个问题和Bean定义里的嵌套泛型没有任何关系，本质是 Helper Bean依赖的MessageConverter泛型类型不匹配，导致Bean实例化流程中断，最终未被注册到Spring容器中。

具体原因拆解 #

• Spring从4.0版本开始就支持基于泛型类型的精确依赖匹配，不会将泛型完全擦除为原始类型做匹配。你使用的Spring Boot 2.6.7对应Spring Framework 5.3.x版本，该机制已经非常成熟，哪怕是EmailDto<MessageDto>这类多层嵌套泛型，Spring也能通过字节码中保留的泛型签名元数据（由ResolvableType类完成解析）做精确匹配，不存在嵌套泛型就无法创建Bean的底层限制。
• 你在prepareMessage这个@Bean方法中，声明的入参类型是MessageConverter<InfoDto, MessageDto>，但同配置类中注册的MessageConverter Bean的泛型绑定是MessageConverter<InfoDto, AzureMessageDto>——两者第二个泛型参数分别为MessageDto和AzureMessageDto，属于完全不同的类型绑定。当前Spring容器中不存在符合泛型要求的MessageConverter实例，导致Helper类型的Bean在实例化阶段就因为依赖缺失失败，自然无法被其他组件注入。
• 同配置类中定义的MessageConverter Bean能正常加载，是因为该Bean实例化不需要额外依赖，直接调用构造方法即可完成创建，不存在依赖匹配失败的问题。
• 自定义库内集成测试运行正常，是因为测试上下文的Bean定义和你当前业务项目不一致：测试环境中必然注册了泛型绑定为MessageConverter<InfoDto, MessageDto>的对应Bean（比如手动注册了实现类、使用Mock替身等），依赖可以正常注入，因此Helper Bean能顺利创建。

修复方向 #

你只需要保证注入到HelperImpl构造方法的MessageConverter实例泛型匹配即可：要么调整messageConverter这个@Bean的返回值泛型为MessageConverter<InfoDto, MessageDto>，并确保MessageConverterImpl实现的是对应泛型接口；要么单独定义一个泛型绑定为<InfoDto, MessageDto>的MessageConverter Bean供Helper实例化使用。

注意：如果你给Bean指定了名称prepareMessage，注入时如果用@Resource(name = "prepareMessage")可以按名称注入绕过类型校验，但更推荐修正泛型匹配关系，避免后续出现类型转换异常。

内容的提问来源于stack exchange，提问作者skyho