SpringBoot中CurrencyConfigurationService配置注入失败求助

核心原因 #

你的CurrencyConfigurationService类同时使用了@Component和带参数的构造函数，Spring Boot会自动为带参构造函数启用@ConstructorBinding（配置属性的构造函数绑定模式），但@Component会把类标记为常规Spring Bean，这两种模式冲突，导致容器无法正确解析依赖注入的来源（是从配置文件取值还是从容器找Bean）。

两种可行解决方案 #

方案一：使用构造函数绑定（推荐，不可变配置） #

移除@Component，显式添加@ConstructorBinding，并通过启动类注解注册配置类：

1. 修改配置类代码：

package spring.boot.learnspringboot.services;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.ConstructorBinding;

@ConstructorBinding
@ConfigurationProperties(prefix = "currency-service")
public class CurrencyConfigurationService {
    // 用final标记，实现不可变配置
    private final String url;
    private final String username;
    private final String key;

    public CurrencyConfigurationService(String url, String username, String key) {
        this.url = url;
        this.username = username;
        this.key = key;
    }

    // 只保留getter，无需setter
    public String getUrl() {
        return url;
    }

    public String getUsername() {
        return username;
    }

    public String getKey() {
        return key;
    }
}

2. 在Spring Boot启动类中添加以下任一注解：

• 直接注册该配置类：@EnableConfigurationProperties(CurrencyConfigurationService.class)
• 扫描指定包下的所有配置属性类：@ConfigurationPropertiesScan(basePackages = "spring.boot.learnspringboot.services")

方案二：使用Setter绑定（兼容常规Bean模式） #

保留@Component，移除带参数的构造函数，添加无参构造函数，通过Setter方法注入配置值：

package spring.boot.learnspringboot.services;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@ConfigurationProperties(prefix = "currency-service")
@Component
public class CurrencyConfigurationService {
    private String url;
    private String username;
    private String key;

    // 必须添加无参构造函数
    public CurrencyConfigurationService() {}

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getKey() {
        return key;
    }

    public void setKey(String key) {
        this.key = key;
    }
}

总结 #

• 构造函数绑定适合不可变配置，更安全，推荐使用；
• Setter绑定适合需要动态修改配置的场景，兼容常规Bean生命周期；
• 不要同时混合两种模式（@Component+带参构造），避免Spring容器解析冲突。

内容的提问来源于stack exchange，提问作者Hamid Sougouma Ali