Hutool中JSONUtil处理大数字溢出的解决方案

背景介绍

在Java开发中，JSON数据的序列化和反序列化是常见操作。Hutool工具库中的JSONUtil类提供了便捷的JSON处理功能，但在处理大数字时会遇到一个典型问题：当数字超过JavaScript能够精确表示的范围时，在浏览器或Node.js环境中解析会出现精度丢失。

问题现象

当使用JSONUtil.toJsonStr()方法序列化包含大数字的Java对象时，生成的JSON字符串中的数字会直接以数值形式呈现。例如：

Demo demo = new Demo();
demo.setId(1227690722069581409L);
demo.setName("pandaer");
String jsonStr = JSONUtil.toJsonStr(demo);
// 输出: {"id":1227690722069581409,"name":"pandaer"}

在JavaScript环境中解析时：

let s = JSON.parse('{"id":1227690722069581409,"name":"pandaer"}');
console.log(s);
// 输出: { id: 1227690722069581300, name: 'pandaer' }

可以看到原始值1227690722069581409被错误地解析为1227690722069581300，这是因为JavaScript的数字类型(Number)遵循IEEE 754标准，只能安全表示-(2^53-1)到2^53-1之间的整数。

解决方案

Hutool在5.8.28版本中增加了对大数字处理的配置选项，开发者可以通过以下方式解决这个问题：

方案一：5.8.28版本写法

String jsonStr = JSONUtil.toJsonStr(demo, 
    JSONConfig.create().setWriteLongAsString(true));

此配置会将所有的long类型值以字符串形式输出，避免前端解析时的精度问题。

方案二：6.0.0版本写法

6.0.0版本提供了更灵活的配置方式：

String jsonStr = JSONUtil.toJsonStr(demo, 
    JSONConfig.of().setNumberWriteMode(NumberWriteMode.STRING));

NumberWriteMode枚举提供了更多选项，可以更精细地控制数字的序列化方式。

注意事项

1. 当同时配置日期格式和大数字处理时，确保配置顺序正确，避免相互影响
2. 这种处理方式会增加少量数据传输量，但保证了数据的精确性
3. 前端解析时需要知道哪些字段是数字字符串，可能需要额外的类型转换

最佳实践

对于需要前后端交互的系统，建议：

1. 统一前后端的大数字处理策略
2. 在接口文档中明确标注可能的大数字字段
3. 考虑使用DTO对象进行类型转换，而不是直接暴露数据库实体

通过合理配置Hutool的JSON序列化选项，可以有效地解决大数字在前端解析时的精度问题，保证系统数据的准确性。