Spring @Bean配置失效：开发环境自动扫描后丢失配置

核心问题定位 #

本地调试时WebClient配置正常，但开发环境中baseUrl和clientConnector均为null，导致请求报错，说明问题出在开发环境的Bean初始化逻辑或依赖加载顺序上，以下是针对性排查方案：

排查与解决步骤 #

1. 修正@Qualifier与Lombok的兼容问题 #

@RequiredArgsConstructor对字段上的@Qualifier支持存在偶发问题，导致注入的不是预期的自定义WebClient Bean：

• 替换为构造函数手动注入，确保Qualifier生效：

@Service
public class ApiClient {
    private final WebClient webClient;

    // 构造函数参数上添加@Qualifier，明确指定Bean
    public ApiClient(@Qualifier("sslClient") WebClient webClient) {
        this.webClient = webClient;
    }

    public String postRequest(String body) {
        return webClient.post()
            .contentType(MediaType.APPLICATION_XML)
            .bodyValue(body)
            .retrieve()
            .bodyToMono(String.class)
            .block();
    }
}

2. 强制自定义WebClient配置优先加载 #

Spring Boot的WebClientAutoConfiguration可能自动生成默认WebClient Bean，覆盖你的自定义Bean：

• 在配置类上添加@AutoConfigureBefore，确保自定义配置优先执行：

@Configuration
@AutoConfigureBefore(WebClientAutoConfiguration.class)
public class WebConfig {

    @Bean
    @Qualifier("sslClient")
    public WebClient webClient(DeviceConfig config, Credentials credentials, HttpClientManager httpClientManager) {
        HttpClient httpClient = httpClientManager.getHttpClient(credentials);
        return WebClient.builder()
            .clientConnector(new ReactorClientHttpConnector(httpClient))
            .baseUrl(config.url)
            .build();
    }
}

3. 检查依赖Bean的加载顺序与有效性 #

开发环境中DeviceConfig、Credentials、HttpClientManager可能未完成初始化就被注入到WebClient：

• 添加@DependsOn强制依赖顺序：

@Bean
@Qualifier("sslClient")
@DependsOn({"deviceConfig", "credentials", "httpClientManager"})
public WebClient webClient(DeviceConfig config, Credentials credentials, HttpClientManager httpClientManager) {
    // ... 原有逻辑
}

• 打印初始化日志验证参数有效性，在WebClient Bean方法中添加日志：

@Bean
@Qualifier("sslClient")
public WebClient webClient(DeviceConfig config, Credentials credentials, HttpClientManager httpClientManager) {
    // 打印参数值，排查开发环境配置是否为空
    System.out.println("DeviceConfig URL: " + config.url);
    HttpClient httpClient = httpClientManager.getHttpClient(credentials);
    System.out.println("Generated HttpClient: " + httpClient);
    
    return WebClient.builder()
        .clientConnector(new ReactorClientHttpConnector(httpClient))
        .baseUrl(config.url)
        .build();
}

• 检查开发环境配置文件，确认config.url是否正确配置，以及Credentials是否包含有效SSL凭证。

4. 清除开发环境上下文缓存 #

Spring DevTools的热部署缓存可能导致旧的空配置Bean被复用：

• 完全重启开发环境应用，清除IDE的Spring上下文缓存；
• 删除项目根目录下的.spring-boot-devtools缓存目录（如果存在）。

5. 验证HttpClientManager的返回值 #

如果httpClientManager.getHttpClient(credentials)在开发环境返回null，会直接导致clientConnector缺失：

• 排查HttpClientManager在开发环境的配置，确认是否正确加载了SSL密钥库/信任库；
• 检查Credentials对象在开发环境的属性是否完整，是否存在配置缺失。

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