每个人都可以，
拥有SSL证书

在 Spring Boot 里用 @ConfigurationProperties 做配置绑定本来是很顺畅的事，但偶尔会碰上注解写了，属性死活注入不进去的情况。

时间一长就发现，出问题的地方翻来覆去就那么几个，干脆把排查过程理一理。

依赖这块，如果项目用的 Spring Boot 版本比较老，低于 2.2 的话，一些自动配置行为不一样，踩坑概率会大一些，建议至少升到 2.2 以上。还有一个很多人会漏掉的点——spring-boot-configuration-processor。

这个依赖是可选的，加上之后能在编译期生成配置元数据，IDE 的提示也会更好，但不会影响运行时的绑定，所以就算漏了它，程序也能跑。如果确定要加，pom 里这样引入：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

加完依赖记得重新 mvn clean install 或者 gradle build 一把，别让 IDE 还在用旧的编译结果。

注解使用不当是最高发的问题。类上忘了加 @Component 或者 @Configuration，Spring 根本扫不到这个类，自然不会去给它绑定属性。

老老实实加上就行。如果你的配置类在第三方 jar 包里，或者你不想用组件扫描，可以直接在主类上用 @EnableConfigurationProperties 显式注册。就算已经加了 @Component，这个注解也能作为一种保险。写法很简单：

@SpringBootApplication
@EnableConfigurationProperties(MyProperties.class)
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Spring Boot 2.2 之后默认启用了配置属性绑定，但如果发现不生效，试试显式声明，经常能立刻解决问题。

配置文件的问题往往出在细节上。

application.properties 里 key 的前缀和字段名要严格对应，比如 prefix = "app"，字段叫 name，那配置项就必须是 app.name。换成 YAML 的话，缩进一定不能错，多一个空格或少一个空格都会导致层级解析失败。

还有一种经常被忽略的情况：IDE 缓存。代码改对了，IDEA 里还标红，但实际跑起来没问题。在 IntelliJ IDEA 里 File -> Invalidate Caches / Restart 一下，然后重新导入 Maven 或 Gradle 项目，基本就能恢复。

多模块项目也容易掉进扫描路径的坑里。配置类放在非主模块，Spring Boot 默认扫描启动类所在包及其子包，其他模块的类自然找不到。在主类上指定 scanBasePackages 能解决：

@SpringBootApplication(scanBasePackages = "com.example")

或者在配置类所在模块用 @ComponentScan 也是可以的。

排查的时候，先把日志级别打开，让框架告诉我们绑定的过程到底发生了什么：

logging.level.org.springframework.boot.context.properties=DEBUG

这比一行行猜快得多。

如果怀疑依赖版本有冲突，mvn dependency:tree | grep "spring-boot" 能直观看到所有相关依赖的版本。实在排查不出来，就建一个最小化示例，只保留配置类和启动类，跑起来验证绑定是否正常，能快速排除业务代码的干扰。

下面是一个完整的最小化示例，可以直接复制过去试。配置类：

@ConfigurationProperties(prefix = "app")
@Component
public class MyProperties {
    private String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

启动类：

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(Application.class, args);
        MyProperties props = context.getBean(MyProperties.class);
        System.out.println("App Name: " + props.getName());
    }
}

配置文件 application.properties：

app.name=MySpringBootApp

跑起来如果控制台打印出了 App Name: MySpringBootApp，说明绑定链路是没问题的，之后就可以把这个经验带到实际项目里排查了。