Spring注册自定义baseUrl的WebClient Bean报错：找不到String类型Bean

错误原因 #

你的gitHubWebClientWithBaseUrl方法标注了@Bean，Spring初始化该Bean时会自动尝试注入方法参数String url，但容器中不存在类型为String的Bean，因此抛出找不到Bean的异常。

解决方案 #

方案1：通过配置参数指定自定义baseUrl #

如果需要支持可配置的自定义baseUrl，将url放入配置文件（如application.yml），通过配置注入后创建对应Bean：

public class ClientConfiguration {

    private static final String GITHUB_BASE_URL = "https://api.github.com/";

    private final ApplicationConfig applicationConfig;
    @Value("${github.custom-base-url:https://api.github.com/}")
    private String customGitHubBaseUrl;

    @Autowired
    public ClientConfiguration(ApplicationConfig applicationConfig) {
        this.applicationConfig = applicationConfig;
    }

    @Primary
    @Bean
    public WebClient gitHubWebClient() {
        return buildWebClient(GITHUB_BASE_URL);
    }

    @Bean("customGitHubWebClient")
    public WebClient customGitHubWebClient() {
        return buildWebClient(customGitHubBaseUrl);
    }

    // 提取公共构建逻辑，避免重复代码
    private WebClient buildWebClient(String baseUrl) {
        return WebClient.builder()
                .baseUrl(baseUrl)
                .defaultHeader("Accept", "application/vnd.github+json")
                .defaultHeader("X-GitHub-Api-Version", "2022-11-28")
                .defaultHeader("Authorization", String.format("Bearer %s", applicationConfig.gitHubToken()))
                .build();
    }
}

使用时通过@Qualifier("customGitHubWebClient")注入对应WebClient，自定义baseUrl可在配置文件中通过github.custom-base-url指定。

方案2：创建WebClient工厂类（支持动态生成） #

如果需要运行时动态传入不同baseUrl创建WebClient，不要给该方法加@Bean，改为工厂方法：

public class ClientConfiguration {

    private static final String GITHUB_BASE_URL = "https://api.github.com/";

    private final ApplicationConfig applicationConfig;

    @Autowired
    public ClientConfiguration(ApplicationConfig applicationConfig) {
        this.applicationConfig = applicationConfig;
    }

    @Primary
    @Bean
    public WebClient gitHubWebClient() {
        return buildWebClient(GITHUB_BASE_URL);
    }

    // 工厂方法：供外部调用生成指定baseUrl的WebClient
    public WebClient createGitHubWebClientWithBaseUrl(String url) {
        return buildWebClient(url);
    }

    private WebClient buildWebClient(String baseUrl) {
        return WebClient.builder()
                .baseUrl(baseUrl)
                .defaultHeader("Accept", "application/vnd.github+json")
                .defaultHeader("X-GitHub-Api-Version", "2022-11-28")
                .defaultHeader("Authorization", String.format("Bearer %s", applicationConfig.gitHubToken()))
                .build();
    }
}

使用时注入ClientConfiguration，调用createGitHubWebClientWithBaseUrl方法传入目标url即可。

方案3：注册多个命名Bean（固定多baseUrl场景） #

如果有几个固定的自定义baseUrl，直接注册多个命名Bean：

public class ClientConfiguration {

    private static final String GITHUB_BASE_URL = "https://api.github.com/";
    private static final String GITHUB_ENTERPRISE_BASE_URL = "https://github.example.com/api/v3/";

    private final ApplicationConfig applicationConfig;

    @Autowired
    public ClientConfiguration(ApplicationConfig applicationConfig) {
        this.applicationConfig = applicationConfig;
    }

    @Primary
    @Bean
    public WebClient gitHubWebClient() {
        return buildWebClient(GITHUB_BASE_URL);
    }

    @Bean("githubEnterpriseWebClient")
    public WebClient githubEnterpriseWebClient() {
        return buildWebClient(GITHUB_ENTERPRISE_BASE_URL);
    }

    private WebClient buildWebClient(String baseUrl) {
        return WebClient.builder()
                .baseUrl(baseUrl)
                .defaultHeader("Accept", "application/vnd.github+json")
                .defaultHeader("X-GitHub-Api-Version", "2022-11-28")
                .defaultHeader("Authorization", String.format("Bearer %s", applicationConfig.gitHubToken()))
                .build();
    }
}

使用时通过@Qualifier("githubEnterpriseWebClient")注入对应客户端。

核心说明 #

• @Bean注解的方法参数会被Spring自动注入，因此不能直接传入运行时动态参数，必须是容器中已存在的Bean或配置注入的值。
• 提取公共构建逻辑到私有方法，既能避免代码重复，也方便统一维护请求头这类公共配置。

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