Java 11 HttpClient Authenticator含德语变音符号密码编码配置问题

问题根源 #

你调试发现的JDK内部逻辑是问题的核心：内置AuthenticationFilter对Basic认证的字符集判断，完全依赖服务端返回的WWW-Authenticate响应头中的charset参数，你在客户端请求中添加的charset头是用于标记请求体编码的，和认证头的编码逻辑无关，因此不会生效。
默认没有识别到UTF-8参数时，认证信息会用ISO-8859-1编码，德语变音符号等非ASCII字符就会出现乱码。

可行解决方案 #

方案1：服务端配合修改（改动最小） #

如果可以调整服务端配置，让服务端返回的WWW-Authenticate响应头携带UTF-8声明即可，格式示例：

WWW-Authenticate: Basic realm="你的业务域", charset="UTF-8"

此时JDK内置的过滤器会自动将isUTF8设为true，密码就会按UTF-8编码发送。

方案2：客户端手动构造认证头（最稳妥，兼容性最高） #

如果无法修改服务端配置，建议放弃使用内置的Authenticator，手动构造Authorization请求头，完全控制编码逻辑，代码示例：

import java.nio.charset.StandardCharsets;
import java.util.Base64;

String username = "testuser";
String password = "täst";
// 手动拼接认证信息，用UTF-8编码后做Base64转换
String credential = username + ":" + password;
String encodedCredential = Base64.getEncoder()
        .encodeToString(credential.getBytes(StandardCharsets.UTF_8));

// 构建请求时直接添加认证头，不需要再给HttpClient配置authenticator
HttpRequest request = HttpRequest.newBuilder().uri(URI.create(url))
        .header("Content-Type", "application/json")
        .header("Authorization", "Basic " + encodedCredential)
        .method("GET", HttpRequest.BodyPublishers.ofString("")).build();

该方案不依赖JDK内部逻辑和服务端配置，所有版本的Java 11+都可以正常运行。

不推荐方案：反射修改内部参数 #

也可以通过反射在运行时修改isUTF8字段的值，但JDK内部类的实现可能随版本迭代变化，容易出现兼容性问题，生产环境不建议使用。

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