Spring Boot配置属性Converter失效，无法转换为Color对象求助

尝试实现一个Converter，将application.yml中的r,g,b格式字符串转换为java.awt.Color对象，但属性解析失败，报错：

org.springframework.core.convert.ConverterNotFoundException: No converter found capable of converting from type [java.lang.String] to type [java.awt.Color]

Converter代码如下：

@Component
public static class ColorConverter implements Converter<String, Color>{
    @Override
    public Color convert(String source) {
      // 解析r,g,b并返回Color对象的逻辑
    }
}      

环境信息 #

• Spring Boot 2.7
• 应用启动类注解：

@SpringBootApplication(scanBasePackages = {"my.packages"})
@EnableTransactionManagement(mode=AdviceMode.ASPECTJ)
@EnableSpringConfigured

• 项目中存在WebMvcConfigurer子类

已尝试的解决方法 #

• 在启动类添加@EnableConfigurationProperties，无效；
• 确认Converter在启动时已被实例化（通过无参构造方法断点验证）；
• 在WebMvcConfigurer中注册该Converter，无效。

问题核心：你定义的Converter默认被注册到Web层的ConversionService中，但Spring Boot的**属性绑定（Configuration Properties）**使用独立的ConversionService，需要专门标记该Converter用于属性绑定场景。

方法1：给Converter添加属性绑定专用注解 #

修改Converter类，添加@ConfigurationPropertiesBinding注解，Spring会自动将该Converter注册到属性绑定专用的ConversionService：

@Component
@ConfigurationPropertiesBinding
public static class ColorConverter implements Converter<String, Color>{
    @Override
    public Color convert(String source) {
        String[] rgbParts = source.split(",");
        int r = Integer.parseInt(rgbParts[0].trim());
        int g = Integer.parseInt(rgbParts[1].trim());
        int b = Integer.parseInt(rgbParts[2].trim());
        return new Color(r, g, b);
    }
}      

方法2：手动注册到全局ConversionService #

如果方法1不生效，可通过配置类手动构建全局ConversionService并添加Converter：

@Configuration
public class ConversionConfig {

    @Bean
    public ConversionService conversionService(ColorConverter colorConverter) {
        DefaultConversionService conversionService = new DefaultConversionService();
        conversionService.addConverter(colorConverter);
        return conversionService;
    }
}

验证注意事项 #

1. 确保配置属性类使用@ConfigurationProperties绑定：

@ConfigurationProperties(prefix = "custom")
@Component
public class CustomProperties {
    private Color primaryColor;

    // getter/setter方法
}

2. application.yml配置格式需匹配Converter解析逻辑：

custom:
  primary-color: 255,0,0

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