反序列化Guava Optional<Long>失败问题求助

看起来你遇到的核心问题是Guava Optional的序列化没有被Jackson的GuavaModule正确处理，导致序列化后输出的是Optional(present=true)这种toString格式，而非内部的实际值，进而反序列化时因为类型不匹配抛出异常。以下是几个你可能遗漏的关键配置和排查点：

1. 确认Guava Datatype模块版本与Jackson核心版本完全匹配 #

Jackson的各个模块（包括GuavaModule）版本必须和核心jackson-databind、jackson-core版本严格一致，否则会出现兼容性问题。你用的是Jackson 2.9.4，那么jackson-datatype-guava的版本也必须是2.9.4，不能混用其他版本。

比如Maven依赖要确保：

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-guava</artifactId>
    <version>2.9.4</version>
</dependency>

2. 确保GuavaModule被正确注册到ObjectMapper #

虽然你提到已经注册了GuavaModule()，但要确认注册代码是生效的，没有被后续的配置覆盖。正确的注册方式应该是：

ObjectMapper objectMapper = new ObjectMapper();
// 注册Guava模块，专门处理Guava的容器类型
objectMapper.registerModule(new GuavaModule());
// 可选：如果需要把空的Optional序列化为null而非空对象，可以添加这个配置
// objectMapper.registerModule(new GuavaModule().configureAbsentsAsNulls(true));

注意：如果你的ObjectMapper是通过Spring等框架自动注入的，要确保模块是在Bean初始化时就注册的，而不是事后手动修改（可能被框架的默认配置覆盖）。

3. 检查序列化/反序列化的字段类型是否一致 #

反序列化报错Cannot deserialize instance of 'java.lang.Long' out of START_OBJECT token，通常意味着：

• 你反序列化的目标字段类型是Long，但传入的JSON是一个代表Guava Optional的对象结构（比如{"present":true,"value":123}）；
• 或者序列化时，字段类型是Guava Optional<Long>，但序列化后没有被处理成原始值，而是Optional的对象结构，导致反序列化到Long字段时不匹配。

要确保：

• 序列化的实体类字段是com.google.common.base.Optional<Long>（不是JDK 8的java.util.Optional，两者是不同类型，GuavaModule只处理Guava的版本）；
• 反序列化的目标字段类型也必须是Guava Optional<Long>，或者如果要直接反序列化为Long，需要确保序列化时就把Optional的内部值输出（这正是GuavaModule应该做的）。

4. 排查是否有其他Jackson模块干扰 #

如果你的项目中同时引入了Jdk8Module（处理JDK 8的Optional），可能会和GuavaModule产生冲突，尤其是如果字段类型被误识别为JDK 8的Optional。此时需要明确指定处理Guava类型的优先级，或者确保只注册需要的模块。

5. 验证序列化结果是否符合预期 #

在调试时，可以手动序列化一个Guava Optional对象，看输出的JSON是否是原始值而非Optional的对象结构：

Optional<Long> testOpt = Optional.of(123L);
String json = objectMapper.writeValueAsString(testOpt);
// 正确的输出应该是"123"，而非"{\"present\":true,\"value\":123}"
System.out.println(json);

如果输出的是后者，说明GuavaModule根本没有生效，需要回到前面的步骤检查依赖和注册是否正确。

内容的提问来源于stack exchange，提问作者Venkat Teki