Java 解析 JSON 文件为什么报错？原因总结

Java解析JSON报错主因是类型、编码、结构或依赖未对齐：JSON语法须严格（双引号、无末尾逗号等）；读取需显式指定UTF-8编码；Java类字段名/类型/嵌套须与JSON一致；Jackson需jackson-core、-annotations、-databind三版本统一。

Java 解析 JSON 文件报错，通常不是 JSON 本身“写错了”，而是解析过程在类型、编码、结构或依赖上没对齐。下面是最常见的几类原因和对应解法。

JSON 格式不合法，但肉眼难发现

JSON 对语法极其严格：必须双引号、不能有末尾逗号、不能用单引号、不能有注释、键名必须加引号。比如以下都是非法的：

• {'name': '张三'} —— 单引号 ❌（必须用 "name"）
• {"age": 25,} —— 末尾逗号 ❌（某些编辑器自动加，Java 解析器不认）
• {"desc": "hello world"} —— 未转义换行符 ❌（应写成 "hello\nworld" 或用多行字符串处理）

建议：用在线校验工具（如 jsonlint.com）粘贴内容验证；或在 Java 中先用 Files.readString(path) 读出原始字符串，打印出来人工检查空格/不可见字符。

字符编码不匹配，中文变乱码或解析中断

JSON 文件存为 UTF-8（推荐无 BOM），但 Java 默认按平台编码读取（Windows 可能是 GBK）。读入后字符串已损坏，再解析必然失败（常见异常：JsonParseException: Unrecognized token 或乱码导致的非法字符）。

立即学习“Java免费学习笔记（深入）”；

• 用 Files.readString(path, StandardCharsets.UTF_8) 显式指定编码
• 用 new InputStreamReader(Files.newInputStream(path), StandardCharsets.UTF_8) 配合 Jackson 的 JsonParser
• 避免用 FileReader（它不支持指定编码，依赖系统默认）

Java 对象结构与 JSON 字段不一致

用 Jackson/Gson 反序列化时，字段名、类型、嵌套层级稍有偏差就会报错。典型表现：

标签： java js json node windows 编码 app 工具 win stream java类 为什么