java中json序列化中文乱码本质是utf-8字节流在生成、传输或解析任一环节被误用gbk/iso-8859-1等编码解码，需从源头排查并端到端统一utf-8编码。
Java 中 JSON 序列化出现中文乱码，本质是字符编码在“生成→传输→解析”任一环节发生错配。不是某个库“有问题”，而是 UTF-8 字节流被当作 GBK、ISO-8859-1 或其他编码解码所致。排查要从源头抓起，解决需端到端对齐。
确认 JSON 字符串生成时是否已乱码
这是第一关。如果序列化后的字符串本身在 Java 内存中就是乱码（比如打印出来是 或 ??），说明问题出在序列化阶段本身：
- 检查你用的 JSON 库是否默认使用平台编码（如 Windows 上 JVM 的
file.encoding=GBK）；Fastjson 1.x 默认不强制 UTF-8，Gson 则通常更健壮 - 避免直接拼接 JSON 字符串：
"{"name":"" + name + ""}"—— 若name是从非 UTF-8 源读入且未转码，此处就已污染 - 推荐显式指定编码能力的写法：用
GsonBuilder().setPrettyPrinting().create()（Gson 自动处理 Unicode）；Fastjson 加上JSON.toJSONString(obj, SerializerFeature.WriteMapNullValue, SerializerFeature.DisableCircularReferenceDetect)并确保 JVM 启动参数含-Dfile.encoding=UTF-8
检查输出/传输通道是否丢失编码信息
即使内存中 JSON 字符串正确，一旦写入文件、响应 HTTP、或传给下游系统，就可能因通道未声明编码而被二次误解：
- 写入文件时：不要用
FileWriter（它依赖系统默认编码），改用OutputStreamWriter(new FileOutputStream(file), StandardCharsets.UTF_8) - HTTP 响应时：必须设置响应头——
response.setContentType("application/json; charset=UTF-8")，且该行要在获取PrintWriter或ServletOutputStream之前调用 - 日志打印时：控制台乱码常因终端编码不匹配，可临时用
System.out.write(jsonString.getBytes(StandardCharsets.UTF_8))验证原始字节是否完好
验证输入源与运行环境编码一致性
很多乱码其实根子不在 JSON 库，而在上游数据进来时就错了：
- 读取 JSON 文件：务必用
InputStreamReader(new FileInputStream(file), StandardCharsets.UTF_8)，别依赖Files.readString(path)（它用系统默认编码） - 接收 HTTP 请求参数：Servlet 中需在读取任何参数前调用
request.setCharacterEncoding("UTF-8")，且前端表单或 AJAX 请求头要带Content-Type: application/json; charset=UTF-8 - 检查 JVM 启动编码：运行
java -XshowSettings:properties -version 2>&1 | findstr file.encoding（Windows）或grep file.encoding（Linux），确认file.encoding和sun.jnu.encoding均为UTF-8
快速定位：三步最小化验证法
不用猜，用可控输入快速锁定问题环节：
-
Step 1：写死一个中文字符串
String raw = "张三";，直接System.out.println(raw)—— 控制台能正常显示？否 → 环境或 IDE 编码问题 -
Step 2：将
raw序列化为 JSON：String json = new Gson().toJson(Map.of("name", raw))，再System.out.println(json)—— 出现\u5f20\u4e09是正常 Unicode 转义；出现??或→ 序列化环节出错 -
Step 3：把
json字符串写入文件并用记事本/VS Code 打开 —— 显示正常？否 → 写入时未指定 UTF-8；显示正常但浏览器打开乱码 → HTTP 响应头缺失charset=UTF-8
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
