如何为Spring的@Value注解注册自定义转换器？

更简便的实现方式 #

可以通过@ConfigurationPropertiesBinding注解标记自定义Converter，这是Spring Boot提供的相对简洁的方案，无需额外配置类：

@Component
@ConfigurationPropertiesBinding
class FooConverter : Converter<String, Foo> {
    override fun convert(source: String): Foo {
        // 在这里实现字符串到Foo的自定义转换逻辑
        return Foo(source)
    }
}

这个注解会将转换器注册到Spring Boot的核心配置属性转换服务中，该服务同时会被用于处理@Value注解的属性注入，完美适配你的需求。

你找到的两种方案的正确性验证 #

两种方案都是有效的，只是适用场景和细节略有不同：

• 方案1（CustomEditorConfigurer）：完全正确。PropertyEditor是Spring原生的类型转换机制，通过该配置器注册的编辑器会被全局应用，所有Bean的@Value属性解析都会使用它，兼容Spring框架的所有版本。
• 方案2（BeanFactoryPostProcessor注册ConversionService）：逻辑正确，但原代码存在小瑕疵——直接创建新的ApplicationConversionService会覆盖Spring Boot默认的转换服务，导致丢失自带的转换器（比如String到LocalDateTime这类常用转换）。优化后的写法如下：

  @Bean
  fun addConversionService(): BeanFactoryPostProcessor = BeanFactoryPostProcessor { beanFactory ->
      val conversionService = beanFactory.getBean(ConversionService::class.java) as ConfigurableConversionService
      conversionService.addConverter(FooConverter())
  }
  

  这种方式是在默认转换服务的基础上添加自定义转换器，更稳妥。

为什么其他尝试未生效 #

• 直接注册Converter<String, Foo> Bean：默认情况下，普通Converter Bean只会被注册到Web层的ConversionService中，不会自动加入处理@Value的环境属性转换体系，因此无法生效。
• 通过WebMvcConfigurer.addFormatters注册：该方式是为Web请求处理注册转换器，触发时机在容器初始化后期，而@Value的属性解析是在Bean实例化阶段完成的，时机晚于属性解析，所以无法作用于@Value注入。

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