故障排查

现象	可能原因与处理方式
解析时出现 ForyJsonException	JSON 语法无效、类型不匹配、映射不受支持、违反深度或对象图内存限制、validator 失败，或存在尾随内容
InsecureException	Fory 禁止列表或配置的 JsonTypeChecker 拒绝了某个类
builder 抛出 IllegalArgumentException	检查配置的深度、对象图内存、并发、保留缓冲区和缓存字段名限制
声明类型写入被拒绝	值不可赋给声明类型、类型包含通配符或类型变量，或者向基本类型提供了 null
不可变值未填充	使用 record、有效的 JsonCreator 或精确的自定义 codec
JsonValue 读取失败	添加一个接收普通 String 的 JsonCreator，或注册精确的自定义 codec
原始 JSON 输出无效	为 JsonRawValue 属性提供且只提供一个可信的完整 JSON 值
无法构造普通对象	添加可用的无参 constructor、使用 record 或 JsonCreator，或注册自定义 codec；Android 和 GraalVM Native Image 的要求更严格
普通 accessor 注解失败	方法不是有效的 public JavaBean accessor，或已启用 field mode
Any 注解失败	只使用一种基于字段的形式，或一对类型解析为 Map<String, V> 的有效方法形式；方法注解要求关闭 field mode
Codec 注解失败	解决同一节点或继承层次冲突、移除被隐藏的嵌套覆盖，或使用具有 public 无参 constructor 的 codec 类
子类型被拒绝	写入时未声明基类、运行时类不是类型表中的精确条目，或输入 JSON 结构与配置的包含方式不一致
无法读取 Collection	目标应为受支持的接口或常见实现，也可以注册自定义 codec
OutputStream 写入失败	底层 IOException 被包装为 ForyJsonException 的 cause

Fory JSON 的映射、语法、codec、深度、对象图内存、validator 和输出失败使用 ForyJsonException。用户 codec 代码仍可能抛出自己的运行时异常。除 Error 以外的 creator 和 validator 失败会连同原始 cause 一起包装。