OpenAPI Generator：如何为Java 11原生HTTP Client添加自定义请求头

针对你遇到的这个问题——服务要求基础认证但不发送WWW-Authenticate挑战头，导致Java 11 HttpClient不会自动携带配置的认证信息——我有两个可行的方案，你可以根据自己的场景选择：

方案一：重写api.mustache模板（直接且全局生效） #

这是你提到的思路，确实是直接解决问题的方法，因为4.3.1版本的生成器没有提供请求自定义的接口，修改模板能让所有生成的API方法自动带上Authorization头。

具体操作：

1. 找到OpenAPI Generator的Java 11模板目录中的api.mustache文件，定位到第126行左右的请求构建代码段。
2. 在构建HttpRequest.Builder的逻辑中，手动添加Authorization头。可以从生成的ApiClient配置中获取用户名和密码，编码后添加：

// 利用ApiClient已有的配置方法获取认证信息
String credentials = apiClient.getUsername() + ":" + apiClient.getPassword();
String encodedCredentials = Base64.getEncoder().encodeToString(credentials.getBytes(StandardCharsets.UTF_8));

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
        .uri(URI.create(basePath + path))
        .header("Authorization", "Basic " + encodedCredentials)
        // 保留原有的header、请求方法等其他配置
        ...;

3. 用修改后的模板重新生成客户端代码，这样所有API请求都会自动携带基础认证头，无需额外配置。

优缺点：

• 优点：全局生效，所有生成的API方法都自动处理认证，无需重复配置。
• 缺点：后续升级OpenAPI Generator版本时，可能需要重新适配模板的变化。

方案二：自定义HttpClient拦截器（更灵活，无需修改模板） #

如果你不想碰模板，这个方案更简洁——利用Java 11 HttpClient的拦截器机制，在请求发送前自动注入Authorization头。

具体实现：

1. 创建一个HttpRequestInterceptor来处理认证头的添加：

import java.nio.charset.StandardCharsets;
import java.util.Base64;
import java.net.http.HttpRequest;
import java.net.http.HttpRequestInterceptor;

HttpRequestInterceptor basicAuthInterceptor = (request, body, context) -> {
    // 从你的应用配置中读取用户名和密码
    String username = "your-username";
    String password = "your-password";
    String authValue = "Basic " + Base64.getEncoder().encodeToString(
            (username + ":" + password).getBytes(StandardCharsets.UTF_8)
    );
    request.headers().set("Authorization", authValue);
};

2. 在初始化生成的ApiClient时，替换默认的HttpClient为添加了拦截器的自定义实例：

import java.net.http.HttpClient;

ApiClient apiClient = new ApiClient();
HttpClient customHttpClient = HttpClient.newBuilder()
        .addInterceptorFirst(basicAuthInterceptor)
        // 保留原有的超时、代理等配置
        .build();
apiClient.setHttpClient(customHttpClient);

3. 之后用这个apiClient创建的所有API服务实例，都会自动在请求中带上认证头。

优缺点：

• 优点：无需修改模板，灵活度高，可以针对不同的ApiClient实例配置不同的认证信息，后续升级Generator版本也不受影响。
• 缺点：需要确保所有使用的ApiClient都正确设置了自定义HttpClient，否则会出现认证失败的情况。

总结 #

如果希望一劳永逸让所有生成的API都自动处理认证，修改模板是首选；如果更看重灵活性和避免模板维护成本，自定义拦截器是更简洁的选择。

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