序列化java.time.ZoneId时Gson为何查找java.time.ZoneRegion？

问题原因解析 #

你遇到的报错核心在于两个关键点：

1. ZoneId的实际运行类型：ZoneId.of("America/New_York")返回的实例是Java.time内部的包私有实现类ZoneRegion，而非ZoneId抽象类本身。
2. Gson的TypeAdapter匹配逻辑：registerTypeAdapter(ZoneId.class, ...)仅为声明类型ZoneId注册适配器，但Gson序列化时会优先检查对象的**运行时实际类型（ZoneRegion）**是否有对应适配器。由于你未给ZoneRegion注册适配器，Gson会尝试用反射序列化它的内部字段，而Java 17的模块系统禁止Gson访问ZoneRegion的包私有字段id，最终抛出异常。

至于添加@Expose和excludeFieldsWithoutExposeAnnotation后能正常运行，是因为修改字段并添加注解后，Gson仅处理带@Expose的字段，此时会严格按照字段的声明类型（ZoneId）查找适配器，你的自定义适配器生效，不会再尝试序列化ZoneRegion的内部字段。

最优解决方案 #

方案1：使用registerTypeHierarchyAdapter（推荐） #

这个方法会为指定类及其所有子类/实现类统一注册适配器，不管实际运行时类型是ZoneRegion还是其他ZoneId实现，都会触发你的自定义序列化逻辑：

Gson gson = new GsonBuilder()
    .registerTypeHierarchyAdapter(ZoneId.class, new ZoneIdAdapter())
    .create();

无需修改实体类字段或添加注解，直接解决类型匹配问题。

方案2：禁用Gson的内部类反射序列化（特定场景适用） #

如果不想使用层级适配器，也可以通过配置Gson禁止对内部类使用反射序列化，但这种方式会影响其他未注册适配器的内部类类型，仅适合严格控制序列化规则的场景：

Gson gson = new GsonBuilder()
    .registerTypeAdapter(ZoneId.class, new ZoneIdAdapter())
    .disableInnerClassSerialization()
    .create();

内容的提问来源于stack exchange，提问作者Kyle Gobel