OpenApi Codegen CLI Java Client：如何正确注入请求头？

方案1：用ApiClient自带的addDefaultHeader方法（最推荐） #

OpenApi生成的ApiClient本身提供了全局请求头添加方法，完全不需要碰不可修改的authentications映射：

ApiClient apiClient = new ApiClient();
// 替换为你的授权头键名和值，比如API Key或Bearer Token
apiClient.addDefaultHeader("Authorization", "Bearer your_token_content");
// 后续用该apiClient生成的所有接口实例，都会自动携带这个请求头
UserServiceApi userApi = new UserServiceApi(apiClient);
userApi.queryUserInfo("123");

这个方法底层维护独立的请求头集合，和authentications逻辑分离，是官方设计的全局配置方式，简单直接。

方案2：自定义请求拦截器实现动态注入 #

如果需要动态获取授权信息（比如从上下文、配置中心实时拉取），可以添加请求拦截器：

ApiClient apiClient = new ApiClient();
apiClient.addInterceptor(request -> {
    // 这里写动态获取授权值的逻辑，比如从ThreadLocal取当前用户token
    String currentToken = AuthContext.getToken();
    return request.newBuilder()
            .header("Authorization", "Bearer " + currentToken)
            .build();
});

拦截器会在每次请求发送前执行，自动注入请求头，适合多线程、动态授权场景。

方案3：修改OpenApi生成模板（彻底放开authentications映射） #

如果一定要通过authentications映射配置，可修改OpenApi Generator的Java模板：

1. 找到生成器的apiClient.mustache模板文件
2. 定位到初始化authentications的代码行，移除Collections.unmodifiableMap()包装
3. 重新生成客户端代码

之后就能直接修改authentications映射：

ApiKeyAuth auth = new ApiKeyAuth("header", "Authorization");
auth.setApiKey("Bearer your_token_content");
apiClient.getAuthentications().put("Authorization", auth);

⚠️ 注意：这种方式会打破原有的线程安全设计，如果多线程共用同一个ApiClient，需要自行处理同步问题。

关于继承ApiClient无效的原因 #

你之前尝试继承ApiClient移除unmodifiableMap没生效，大概率是因为生成的ApiClient构造函数会强制调用init()方法，而你的子类没有完全覆盖初始化逻辑，导致原有的不可修改映射依然被创建。直接用前两种方案或修改模板，比继承子类更可靠。

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