一、问题现象与核心矛盾

当Java程序通过HTTP请求调用DeepSeek API并传递中文参数时，返回的JSON数据可能出现以下乱码场景：

1. 响应体中的中文字符显示为\uXXXX Unicode转义序列
2. 直接显示为?或方框等不可识别符号
3. 完整JSON结构解析失败，抛出JsonParseException

这种乱码本质是字符编码处理过程中的信息失真，涉及三个关键环节：

• 请求编码：中文参数在HTTP请求中的编码方式
• 传输协议：HTTP头部的Content-Type声明
• 响应解码：Java对HTTP响应体的解码处理

二、编码问题根源深度解析

1. 请求阶段的编码陷阱

使用HttpURLConnection或OkHttp等客户端时，若未显式设置字符编码，默认使用ISO-8859-1处理请求体。例如：

// 错误示例：未设置编码的POST请求
URL url = new URL("https://api.deepseek.com/v1/chat");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
// 中文参数直接写入输出流
String jsonInput = "{\"prompt\":\"你好，世界\"}";
try(OutputStream os = conn.getOutputStream()) {
    byte[] input = jsonInput.getBytes(); // 默认使用平台编码
    os.write(input);
}

此时若系统默认编码非UTF-8（如Windows的GBK），服务端接收到的将是乱码数据，导致处理异常。

2. 响应阶段的解码失误

当服务端正确返回UTF-8编码的JSON时，Java客户端的解码方式决定最终结果：

// 错误示例：未指定编码的响应读取
try(InputStream is = conn.getInputStream();
    BufferedReader reader = new BufferedReader(new InputStreamReader(is))) {
    String line;
    while((line = reader.readLine()) != null) {
        System.out.println(line); // 依赖系统默认编码
    }
}

若系统默认编码与响应体实际编码（UTF-8）不一致，必然产生乱码。

3. JSON库的隐式转换

部分JSON库（如早期版本的org.json）在解析时可能进行二次编码转换。当接收到\uXXXX格式的Unicode字符串时，若库配置不当会导致双重解码。

三、系统性解决方案

1. 请求编码规范（推荐方案）

使用UTF-8编码请求体

// 正确示例：显式指定UTF-8编码
String jsonInput = "{\"prompt\":\"你好，世界\"}";
conn.setRequestProperty("Content-Type", "application/json;charset=UTF-8");
try(OutputStream os = conn.getOutputStream()) {
    byte[] input = jsonInput.getBytes(StandardCharsets.UTF_8); // 明确指定编码
    os.write(input);
}

使用OkHttp的编码最佳实践

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
String jsonBody = "{\"prompt\":\"你好，世界\"}";
RequestBody body = RequestBody.create(jsonBody, JSON);
Request request = new Request.Builder()
    .url("https://api.deepseek.com/v1/chat")
    .post(body)
    .build();

2. 响应解码规范

强制使用UTF-8解码响应

// 正确示例：指定UTF-8的响应读取
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());
}

处理重定向时的编码保持

当发生302重定向时，需确保编码链不断裂：

conn.setInstanceFollowRedirects(true); // 允许自动重定向
// 需验证重定向后的响应头是否保持UTF-8声明

3. JSON解析层防护

使用Jackson的自动检测

ObjectMapper mapper = new ObjectMapper();
mapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_CONTROL_CHARS, true);
mapper.configure(JsonParser.Feature.AUTO_CLOSE_SOURCE, true);
String jsonResponse = "..."; // 包含中文的响应
ChatResponse response = mapper.readValue(
    new InputStreamReader(
        new ByteArrayInputStream(jsonResponse.getBytes(StandardCharsets.UTF_8)),
        StandardCharsets.UTF_8
    ), 
    ChatResponse.class
);

Gson的编码配置

Gson gson = new GsonBuilder()
    .disableHtmlEscaping() // 防止HTML转义
    .create();
String json = "{\"result\":\"测试数据\"}";
ApiResponse resp = gson.fromJson(json, ApiResponse.class);

四、高级调试技巧

1. 网络抓包分析

使用Wireshark或Fiddler捕获原始HTTP流量，验证：

• 请求头的Content-Type是否包含charset=UTF-8
• 响应头的Content-Type是否声明正确编码
• 实际传输的字节流是否符合预期

2. 编码验证工具

// 字节级编码验证
String testStr = "中文测试";
byte[] utf8Bytes = testStr.getBytes(StandardCharsets.UTF_8);
System.out.println(Arrays.toString(utf8Bytes)); 
// 应输出: [-26, -75, -117, -24, -81, -107, -28, -72, -83, -27, -101, -67]

3. 服务端日志对照

建议同时检查：

• 服务端接收到的原始请求体（确认中文是否完整到达）
• 服务端返回的原始响应体（确认编码声明与实际内容一致）

五、最佳实践建议

1. 统一编码标准：全流程强制使用UTF-8，包括：

   • 源代码文件编码
   • 请求/响应编码
   • 日志文件编码

2. 编码声明完整性：确保HTTP头同时包含：

   Content-Type: application/json; charset=utf-8

3. 异常处理机制：

   try {
    // API调用代码
   } catch (UnsupportedEncodingException e) {
    log.error("系统不支持UTF-8编码", e);
    throw new IllegalStateException("环境配置错误", e);
   } catch (JsonParseException e) {
    log.error("JSON解析失败，可能是编码问题", e);
    // 附加原始响应内容调试
   }

4. 测试用例覆盖：

   • 纯中文参数测试
   • 中英文混合参数测试
   • 特殊符号（表情符号、生僻字）测试

六、常见误区警示

1. 过度依赖默认编码：String.getBytes()和new String(bytes)必须显式指定编码
2. 混淆编码与解码：写入时需要编码（String→byte[]），读取时需要解码（byte[]→String）
3. 忽略BOM头：某些UTF-8实现可能包含BOM（Byte Order Mark），需特殊处理
4. 错误使用字符流：InputStreamReader和OutputStreamWriter必须指定编码

通过系统实施上述方案，可彻底解决Java调用DeepSeek API时的中文乱码问题。实际开发中建议将编码处理封装为工具类，例如：

public class HttpEncodingUtil {
    public static String readResponse(InputStream is) throws IOException {
        try (BufferedReader reader = new BufferedReader(
                new InputStreamReader(is, StandardCharsets.UTF_8))) {
            return reader.lines().collect(Collectors.joining());
        }
    }
    public static void writeRequest(OutputStream os, String content) throws IOException {
        os.write(content.getBytes(StandardCharsets.UTF_8));
    }
}

这种封装既保证了编码一致性，又简化了调用方的使用复杂度。