一、问题现象与根源分析

当Java程序通过HTTP请求调用DeepSeek API时，若请求参数或响应内容包含中文字符，常出现以下两种乱码场景：

1. 请求参数乱码：中文参数在传输过程中被错误编码，导致API服务器无法正确解析
2. 响应数据乱码：API返回的JSON数据中包含中文时显示为乱码或问号

这种问题本质上源于字符编码处理不当。HTTP协议传输文本数据时需要明确指定字符编码方式，而Java的HTTP客户端（如HttpURLConnection、Apache HttpClient等）默认编码策略与API服务端编码配置不匹配时，就会产生乱码。

1.1 编码机制解析

HTTP协议通过两个关键字段控制字符编码：

• Content-Type：响应头中声明媒体类型及字符集，如application/json; charset=utf-8
• Accept-Charset：请求头中声明客户端支持的字符集列表

当服务端返回的字符集声明与客户端实际解码方式不一致时，就会产生乱码。例如服务端使用UTF-8编码而客户端按ISO-8859-1解码。

二、系统性解决方案

2.1 请求阶段编码处理

2.1.1 设置正确的请求头

使用HttpURLConnection时，必须显式设置Accept-Charset和Content-Type头：

URL url = new URL("https://api.deepseek.com/v1/chat");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Accept-Charset", "UTF-8");
conn.setRequestProperty("Content-Type", "application/json;charset=UTF-8");
conn.setRequestProperty("Accept", "application/json");

2.1.2 参数编码处理

对于POST请求的JSON体，需确保字符串以UTF-8编码写入输出流：

String jsonBody = "{\"prompt\":\"这是中文测试\",\"temperature\":0.7}";
conn.setDoOutput(true);
try(OutputStream os = conn.getOutputStream()) {
    byte[] input = jsonBody.getBytes(StandardCharsets.UTF_8);
    os.write(input, 0, input.length);
}

2.2 响应阶段解码处理

2.2.1 正确获取响应流

必须通过getInputStream()获取响应流，而非getErrorStream()：

try(InputStream is = conn.getInputStream();
    BufferedReader reader = new BufferedReader(
        new InputStreamReader(is, StandardCharsets.UTF_8))) {
    StringBuilder response = new StringBuilder();
    String line;
    while ((line = reader.readLine()) != null) {
        response.append(line);
    }
    System.out.println(response.toString());
}

2.2.2 使用第三方库的优化方案

推荐使用Apache HttpClient或OkHttp等成熟HTTP客户端库，它们内置了完善的编码处理机制：

// Apache HttpClient示例
CloseableHttpClient httpClient = HttpClients.createDefault();
HttpPost post = new HttpPost("https://api.deepseek.com/v1/chat");
post.setHeader("Content-Type", "application/json;charset=UTF-8");
StringEntity entity = new StringEntity(
    "{\"prompt\":\"中文参数\"}", 
    ContentType.APPLICATION_JSON.withCharset("UTF-8")
);
post.setEntity(entity);
try (CloseableHttpResponse response = httpClient.execute(post)) {
    String result = EntityUtils.toString(response.getEntity(), "UTF-8");
    System.out.println(result);
}

2.3 JSON解析库配置

即使HTTP层编码正确，JSON解析库也可能因配置不当导致乱码。使用Jackson库时需确保：

ObjectMapper mapper = new ObjectMapper();
// 显式设置字符集（通常非必须，但可作为防御性编程）
mapper.getFactory().setCharacterEscapes(new CustomCharacterEscapes());
String json = "{\"response\":\"中文内容\"}";
ApiResponse response = mapper.readValue(json, ApiResponse.class);

三、常见问题排查

3.1 诊断工具使用

1. 抓包分析：使用Wireshark或Fiddler捕获原始HTTP流量，检查Content-Type头和实际数据编码
2. 十六进制查看：将乱码响应保存为文件，用十六进制编辑器查看原始字节，确认是否为有效UTF-8序列

3.2 典型错误场景

1. 服务端未声明字符集：某些API可能返回Content-Type: application/json而不指定charset，此时客户端应默认按UTF-8处理
2. 代理服务器修改：企业网络中的代理服务器可能篡改响应头，需检查完整请求链路
3. IDE控制台编码：即使数据正确，IDE控制台可能使用错误编码显示，需确认控制台字符集设置

四、最佳实践建议

1. 统一使用UTF-8：在项目所有层级（数据库、应用、网络）强制使用UTF-8编码

2. 封装HTTP工具类：创建包含标准编码配置的HTTP工具类，避免重复编码

   public class ApiClient {
    private static final String CHARSET = "UTF-8";
    public static String post(String url, String jsonBody) throws IOException {
        // 实现包含完整编码配置的POST请求
        // ...
    }
   }

3. 异常处理：添加编码相关的异常处理逻辑

   try {
    // HTTP请求代码
   } catch (UnsupportedEncodingException e) {
    throw new RuntimeException("系统不支持UTF-8编码", e);
   } catch (ProtocolException e) {
    throw new RuntimeException("HTTP协议异常", e);
   }

五、进阶优化方案

对于高并发场景，建议：

1. 连接池管理：使用HttpClient连接池复用连接
2. 异步处理：采用CompletableFuture或响应式编程处理异步API调用
3. 缓存策略：对相同中文参数的请求结果进行缓存

通过系统性地处理请求编码、响应解码和JSON解析三个环节，配合完善的错误处理和诊断机制，可以彻底解决Java调用DeepSeek API时的中文乱码问题。实际开发中，建议将HTTP通信逻辑封装为独立模块，通过接口隔离编码细节，提升代码的可维护性。