在spring boot中，若在@configuration类中直接使用@value注解于字段上初始化bean，可能因属性加载时机早于配置绑定而失败；推荐通过构造函数注入确保属性已就绪。
在Spring应用上下文启动过程中，@Configuration类的实例化与@Bean方法的执行依赖于属性源（如application.properties）的加载顺序。当@Value直接标注在类字段上（如int connectionTimeout）时，该字段会在Bean实例化早期被尝试注入——但此时PropertySourcesPlaceholderConfigurer可能尚未完成对配置文件的解析与占位符替换，从而导致IllegalArgumentException或默认值未生效等问题。
根本解决方案：构造函数注入（推荐）
Spring 4.3+ 支持自动构造函数注入，且从Spring Boot 2.1起，默认启用@ConstructorBinding语义（尤其配合@ConfigurationProperties）。但即使使用原生@Value，构造函数注入也能严格保证依赖属性在对象创建时已解析完毕：
@Configuration
@Slf4j
public class WebClientConfig {
private final int connectionTimeout;
private final int responseTimeout;
// 构造函数注入：Spring在实例化Config时即解析并传入属性值
public WebClientConfig(
@Value("${connectionTimeout:30000}") int connectionTimeout,
@Value("${responseTimeout:30000}") int responseTimeout) {
this.connectionTimeout = connectionTimeout;
this.responseTimeout = responseTimeout;
}
@Bean
public ClientHttpConnector getConnector() {
HttpClient client = HttpClient.create()
.option(ChannelOption.CONNECT_TIMEOUT_MILLIS, connectionTimeout)
.responseTimeout(Duration.ofMillis(responseTimeout));
return new ReactorClientHttpConnector(client);
}
@Bean
public WebClient webClient(ClientHttpConnector connector) {
return WebClient.builder()
.defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_FORM_URLENCODED_VALUE)
.clientConnector(connector)
.build();
}
}✅ 优势说明：
- 属性值在WebClientConfig构造阶段即完成注入，完全规避“属性未加载”问题；
- 支持默认值（如"${connectionTimeout:30000}"），增强健壮性；
- 符合不可变设计原则（字段可声明为final）；
- 与Lombok @RequiredArgsConstructor天然兼容（若需简化代码）。
⚠️ 注意事项：
- 避免在@Bean方法参数中再次使用@Value（如getConnector(@Value("...") int t)），这不符合Spring Bean生命周期规范；
- 若超时配置项较多或存在逻辑分组，应优先选用@ConfigurationProperties + @Validated，实现类型安全、松耦合与校验能力；
- 确保application.properties位于src/main/resources且无拼写错误（如connectionTimeout ≠ connection-timeout，后者需启用relaxed-binding或改用@ConfigurationProperties）。
综上，构造函数注入@Value是最轻量、可靠且符合Spring最佳实践的初始化方案——它不依赖额外注解，无需修改配置加载机制，即可确保属性在Bean构建前就绪。
