# FastJSON与Jackson序列化的区别——踩过的一百个坑

原创已于 2025-04-18 11:19:00 修改 · 722 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#踩过的一百个坑 #java #Json

于 2025-04-18 11:03:00 首次发布

踩过的一百个坑专栏收录该内容

3 篇文章

订阅专栏

FastJSON与Jackson序列化的区别——踩过的一百个坑

问题背景

在与第三方API对接时，涉及到层级嵌套过深，接口提供加密方法可能会出现差异，导致传输后校验sign不正确，因此可能会需要自己这边先对嵌套的List进行Json化，再加密，之后进行传输，但今天遇到的一个问题比较邪门。无论怎么传都得到接口返回，api sign 不正确，仔细检查了方法，发现问题只能在Json时出现问题，由于我使用的是内部封装JsonUtils，所使用Jackson实现。

先说结论：特别是在处理大数字（如雪花算法生成的ID）时，FastJSON和Jackson的默认行为存在显著差异，可能导致接口调用失败。

现象描述

考虑以下示例数据：

class Order {
    private Long id = 1912712976293294081L;
    // 其他字段...
}

使用不同库序列化的结果：

// FastJSON结果
{"id": 1912712976293294081}

// Jackson结果
{"id": "1912712976293294081"}

原因分析

FastJSON:
- 默认保持数字类型
- 对大数字采用原样输出
- 不做特殊处理
Jackson:
- 默认将大数字转换为字符串
- 这样做是为了防止JavaScript处理大数字时的精度损失
- JavaScript的Number类型最大安全整数是2^53-1

解决方案

1. 修改Jackson配置

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 禁用将大数字转换为字符串
        mapper.configure(JsonGenerator.Feature.WRITE_NUMBERS_AS_STRINGS, false);
        return mapper;
    }
}

2. 使用注解方式

public class Order {
    @JsonSerialize(using = ToStringSerializer.class)
    private Long id;
}

3. 全局配置序列化器

@Configuration
public class JacksonConfig {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer customizer() {
        return builder -> builder.serializerByType(Long.class, ToStringSerializer.instance)
                               .serializerByType(Long.TYPE, ToStringSerializer.instance);
    }
}

最佳实践建议

API文档优先
- 仔细阅读第三方API文档
- 确认字段类型要求
- 进行接口测试验证
统一序列化策略
- 项目中统一使用一种序列化库
- 保持配置一致性
- 做好文档说明
测试验证
- 编写单元测试
- 使用Postman等工具验证
- 记录关键数据日志

示例代码

// 调试代码
@Slf4j
public class JsonTest {
    public void compareJsonOutput() {
        Order order = new Order();
        
        // FastJSON输出
        String fastJsonStr = JSONObject.toJSONString(order);
        log.info("FastJSON结果: {}", fastJsonStr);
        
        // Jackson输出
        String jacksonStr = objectMapper.writeValueAsString(order);
        log.info("Jackson结果: {}", jacksonStr);
    }
}