Spring Boot 3.2.1配置属性绑定失败，@ConditionalOnProperty不生效

排查与解决方案 #

1. 调整配置属性类的构造器绑定逻辑

Spring Boot 3.2.x对构造器绑定的校验更严格。当前WebAuthConfigurationProperties仅用@Getter但未显式定义构造器，或构造器参数未处理可选字段的默认值，导致缺失属性时绑定失败。

修复方式：
给配置类添加显式构造器，为可选字段设置默认值：

@ConfigurationProperties(prefix = "foo.web.auth")
@Getter
public class WebAuthConfigurationProperties {
  private final String endpoint;
  private final String loadBalancingPolicy;
  private final KeyConfiguration key;
  private final boolean tracingEnabled;
  private final Token token;
  private final RetryPolicies retryPolicies;

  public WebAuthConfigurationProperties(String endpoint,
                                       @Nullable String loadBalancingPolicy,
                                       @Nullable KeyConfiguration key,
                                       boolean tracingEnabled,
                                       Token token,
                                       @Nullable RetryPolicies retryPolicies) {
    this.endpoint = endpoint;
    this.loadBalancingPolicy = loadBalancingPolicy != null ? loadBalancingPolicy : "round-robin";
    this.key = key != null ? key : new KeyConfiguration(); // 假设KeyConfiguration有默认构造器
    this.tracingEnabled = tracingEnabled;
    this.token = token;
    this.retryPolicies = retryPolicies != null ? retryPolicies : new RetryPolicies();
  }
}

2. 让配置属性类受开关控制

注意：@ConditionalOnProperty仅作用在自动配置类上，不会阻止@ConfigurationProperties注解类的Bean创建。即使WebAuthEnabledAutoConfiguration不生效，配置属性类依然会尝试绑定所有属性，缺失字段时抛出异常。

修复方式：
给配置属性类添加条件注解，仅在开关开启时才创建：

@ConfigurationProperties(prefix = "foo.web.auth")
@Getter
@ConditionalOnProperty(value = "foo.web.auth.enabled", havingValue = "true")
public class WebAuthConfigurationProperties {
  // 原有字段与构造器
}

或者放宽绑定严格性（适合需要保留配置类但允许缺失属性的场景）：

@ConfigurationProperties(prefix = "foo.web.auth", ignoreUnknownFields = true, ignoreInvalidFields = true)
@Getter
public class WebAuthConfigurationProperties {
  // 原有字段与构造器
}

3. 补充配置文件中缺失的必填属性

异常提示绑定失败，说明配置yaml中缺少WebAuthConfigurationProperties声明的某些字段（如loadBalancingPolicy、key、retryPolicies）。

修复方式：
在配置文件中补充缺失的属性，例如：

foo:
  web:
    auth:
      enabled: true
      endpoint: https://auth-headless.auth:8443
      loadBalancingPolicy: round-robin
      tracingEnabled: false
      token:
        fakeAuth: true
      key:
        secret: default-secret
      retryPolicies:
        maxAttempts: 3
        backoff: 1000

4. 验证依赖库与Spring Boot版本兼容性

如果以上方法都无效，检查依赖库是否适配Spring Boot 3.2.x版本。部分库在Spring Boot大版本升级后，内部配置逻辑可能需要调整，可以尝试降级到Spring Boot 3.2.0或等待依赖库发布适配版本。

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