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免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 用 Files.readString(path, StandardCharsets.UTF_8) 显式指定编码
- 用 new InputStreamReader(Files.newInputStream(path), StandardCharsets.UTF_8) 配合 Jackson 的 JsonParser
- 避免用 FileReader（它不支持指定编码，依赖系统默认）
Java 对象结构与 JSON 字段不一致
用 Jackson/Gson 反序列化时，字段名、类型、嵌套层级稍有偏差就会报错。典型表现：
- MismatchedInputException: Cannot construct instance → JSON 有字段，Java 类没有对应属性（或没 getter/setter/无参构造）
- JsonMappingException: Can not deserialize instance → 类型不匹配，如 JSON 是 "count": "5"（字符串），Java 字段却是 int count
- JSON 是数组，Java 期望单个对象（或反过来）→ 忘加 List
或 @JsonProperty 注解适配别名
建议：开启 Jackson 的宽松模式（DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY 等），或先用 JsonNode 做动态解析，确认结构后再映射。
依赖版本冲突或缺失关键模块
尤其用 Jackson 时，常见坑：
- 只引入 jackson-databind，但漏了 jackson-core 或 jackson-annotations → 运行时报 NoClassDefFoundError
- Maven 多模块中，不同子模块引入了 Jackson 2.12 和 2.15 → 版本冲突导致 InvalidDefinitionException
- 用了 @JsonCreator 但没加 @JsonProperty 参数名 → 构造函数参数绑定失败
检查方式：运行 mvn dependency:tree | grep jackson，确保核心三件套版本统一；IDE 中 Ctrl+Click 进入 ObjectMapper 类，看是否能正常跳转。
基本上就这些。多数时候不是代码写得不对，而是 JSON 文件、读取方式、Java 类定义、依赖环境这四者之间没对齐。逐项排查，比盲目搜异常更高效。
