Spring Boot生成ApiClient构造器多Bean匹配错误排查求助

OpenApi Generator生成的ApiClient类带有@Autowired注解的RestTemplate参数构造器，这会触发Spring的自动Bean创建逻辑。当容器中存在多个RestTemplate Bean时，Spring无法自动选择合适的实例，导致歧义报错——即便你手动配置了指定的ApiClient Bean，Spring仍会尝试自动生成默认的ApiClient Bean，从而引发冲突。

1. 修改OpenApi Generator配置，禁用自动注入 #

在生成代码时，关闭useAutowiredWithRestTemplate选项，让生成的ApiClient构造器不带@Autowired注解，避免Spring自动尝试创建该Bean。

如果使用Maven插件，在pom.xml的OpenApi Generator配置中添加：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>你的版本号</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 其他配置 -->
                <useAutowiredWithRestTemplate>false</useAutowiredWithRestTemplate>
            </configuration>
        </execution>
    </executions>
</plugin>

如果使用Gradle插件，在build.gradle中添加：

openApiGenerate {
    // 其他配置
    useAutowiredWithRestTemplate = false
}

2. 阻止Spring自动扫描生成的ApiClient类 #

如果无法修改生成配置，可在Spring启动类中排除ApiClient的自动扫描，避免Spring尝试自动创建该Bean：

@SpringBootApplication(
    exclude = {ApiClient.class},
    scanBasePackages = {"你的业务包", "你的配置包"}
)
// 或者用@ComponentScan排除
@ComponentScan(
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.ASSIGNABLE_TYPE,
        value = ApiClient.class
    )
)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 确保自定义ApiClient Bean配置正确 #

检查你的LimitApiRestTemplateAutoConfiguration配置类，确保Bean定义明确指定了RestTemplate的限定符，且配置类被Spring扫描到：

@Configuration
public class LimitApiRestTemplateAutoConfiguration {

    @Bean("accountApiClient")
    public ApiClient accountApiClient(@Qualifier("fdsRestTemplate") RestTemplate fdsRestTemplate) {
        ApiClient apiClient = new ApiClient(fdsRestTemplate);
        // 按需配置basePath、拦截器等
        apiClient.setBasePath("你的API基础路径");
        return apiClient;
    }
}

调用ApiClient时，通过@Qualifier("accountApiClient")注入自定义Bean：

@Service
public class YourService {
    private final ApiClient accountApiClient;

    public YourService(@Qualifier("accountApiClient") ApiClient accountApiClient) {
        this.accountApiClient = accountApiClient;
    }

    // 业务逻辑
}

不推荐的方案：使用@Primary标记默认RestTemplate #

虽然可以给某个RestTemplate添加@Primary注解让Spring优先选择，但这会影响其他依赖RestTemplate的组件，可能引发其他歧义问题，仅在无其他方案时临时使用。

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