Jackson异常链深因多层框架包装，须用getCause()逐层提取至JsonParseException等原始异常，结合getPath()和getLocation()定位字段与JSON位置。
Jackson 反序列化 JSON 出错时，原始异常常被多层包装（比如 JsonMappingException → RuntimeException → InvocationTargetException），直接打印 e.getMessage() 或 e.toString() 往往只显示顶层包装信息，看不到真正的字段名、类型不匹配位置或 JSON 解析错误点。这时必须用 getCause() 逐层向下提取，才能定位到 Jackson 内部抛出的原始异常（如 JsonParseException、MismatchedInputException 或自定义反序列化器里的 IllegalArgumentException）。
为什么 Jackson 异常链特别深
Jackson 本身异常通常不直接暴露给业务层。常见嵌套路径包括：
- 外部调用方（如 Spring MVC 的
@RequestBody）捕获到的是HttpMessageNotReadableException，其cause是JsonMappingException -
JsonMappingException的cause可能是JsonParseException（JSON 格式错误）或MismatchedInputException（类型不匹配，如字符串赋给 int 字段） - 若用了自定义
JsonDeserializer，内部 throw 的异常会被JsonMappingException包装，成为它的cause，再往上可能又被InvocationTargetException或UndeclaredThrowableException包裹
推荐的深度提取方式（带安全防护）
不要只调一次 getCause()，要循环提取直到 null 或达到合理深度上限（建议 8–12 层，Jackson 常见嵌套不超过 6 层）。同时避免空指针和无限循环（例如某些框架会把 cause 指向自己）：
- 用
IdentityHashSet记录已见过的异常引用，防止环形引用 - 限制最大遍历层数（如 10），避免栈溢出或死循环
- 优先检查是否为 Jackson 原生异常（
JsonParseException、MismatchedInputException、InvalidFormatException），它们含关键定位信息（getLocation()、getPath()） - 对
JsonMappingException，可直接调用getOriginalMessage()和getPathReference()，比单纯看 cause 更高效
实战中快速定位字段级问题
当报错提示 “Cannot deserialize instance of `X` out of VALUE_STRING token” 时，仅靠顶层异常无法知道是哪个字段出错。正确做法是：
立即学习“Java免费学习笔记（深入）”；
- 拿到
JsonMappingException后，调用e.getPath()获取字段路径（如[“user”, “age”]） - 调用
e.getLocation().getSourceRef()查看原始 JSON 行号列号 - 若
e.getCause()是NumberFormatException，说明目标字段类型是数字但输入了非法字符串，此时getCause().getMessage()会明确写 “For input string: \”abc\”” - 若使用 Lombok 的
@Builder+ Jackson，还可能遇到InvalidDefinitionException，它的cause往往指向构造器参数缺失或不可访问
日志与调试建议
在 catch 块中不要只记录 e.getMessage()：
- 记录
e.getClass().getSimpleName()+e.getCause() != null ? e.getCause().getClass().getSimpleName() : "no cause" - 对 Jackson 异常，额外打印
e.getProcessor().getParsingContext().getCurrentName()（需确保未关闭上下文） - 开发期开启 Jackson 的详细错误模式：
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)避免干扰，但上线前应设为 true 并配合getCause()精准捕获 - 用工具类封装提取逻辑，例如
ExceptionUtils.findRootJacksonCause(e)，内部自动跳过非 Jackson 的中间包装层
