Charles 5.0 抓包中文乱码如何解决？

Question

在使用 Charles 5.0 进行抓包时，部分开发者会遇到响应内容中的中文显示为乱码的问题，尤其在查看 HTTP 请求的响应数据时更为明显。造成这一问题的常见原因包括：服务器返回的编码格式未被 Charles 正确识别，或响应头中未明确指定字符集（如 UTF-8）。此外，Charles 默认使用系统编码解析响应内容，若系统编码与实际返回内容不一致，也会导致乱码。解决方法包括：手动设置 Charles 的编码格式为 UTF-8；在响应查看器中切换合适的字符集；或通过修改 Charles 配置文件强制指定默认编码方式。掌握这些调试技巧，有助于提升接口调试与问题排查效率。

Answer 1

一、问题现象：Charles 5.0 抓包时中文响应内容显示乱码

在使用 Charles 5.0 进行 HTTP/HTTPS 抓包调试时，部分开发者发现响应体中的中文内容显示为乱码。尤其在查看 JSON、XML 或 HTML 类型的响应数据时，这一问题尤为常见。

• 乱码表现为“”、“？？”或类似字符。
• 问题通常出现在非 UTF-8 编码返回的数据中。
• 某些服务器未在响应头中明确指定字符集。

二、问题原因分析

导致 Charles 中文显示乱码的主要原因包括：

1. 服务器响应未在 Content-Type 头中指定字符集（如 charset=UTF-8）。
2. 服务器返回内容使用非 UTF-8 编码（如 GBK、GB2312、ISO-8859-1 等）。
3. Charles 默认使用系统编码（如 Windows 系统可能是 GBK）解析响应内容。
4. 响应体中未包含 BOM（Byte Order Mark）头，导致编码识别失败。

三、解决方案汇总

以下是解决 Charles 中文乱码问题的多种方法，开发者可根据实际情况选择：

方法编号	解决方案	适用场景
1	手动设置响应内容的编码为 UTF-8	临时查看特定响应内容
2	通过 Charles 的响应查看器切换字符集	快速尝试多种编码格式
3	修改 Charles 配置文件，设置默认编码方式	长期解决系统编码导致的乱码问题
4	服务器端统一返回 UTF-8 编码内容	从源头解决问题，适用于后端开发人员

四、详细操作步骤

以下是具体操作步骤，以帮助开发者逐步排查并解决乱码问题：

# 方法一：手动设置编码格式
1. 打开 Charles，选中需要查看的请求。
2. 切换到 "Response" 标签页。
3. 点击右下角的 "Encoding" 下拉菜单。
4. 选择 "UTF-8" 或其他合适编码格式。

# 方法二：修改 Charles 默认编码
1. 找到 Charles 安装目录下的配置文件（如 charles.vmoptions）。
2. 添加如下行：
   -Dfile.encoding=UTF-8
3. 重启 Charles 生效。
  

五、流程图：乱码问题排查流程

graph TD
      A[开始] --> B{响应内容乱码？}
      B -- 是 --> C{是否有 Content-Type 指定 charset？}
      C -- 是 --> D{响应编码是否为 UTF-8？}
      D -- 是 --> E[检查系统编码]
      D -- 否 --> F[在 Charles 中切换编码格式]
      C -- 否 --> G[尝试手动设置编码]
      B -- 否 --> H[正常显示]
      E --> I{系统编码是否与响应一致？}
      I -- 是 --> H
      I -- 否 --> J[修改 Charles 默认编码]