一场“数据穿越”的悬案根因:JS 的数字装不下 Java 的 Long修复思路:序列化时把 Long 变字符串项目里的具体实现一个容易踩的坑,和顺手修的两件事改完之后
干后端的兄弟估计都遇过这种时刻:日志里一切都对,接口没报错,测试环境跑得欢,偏偏就是数据不对。今天分享的这位后端,就被这样一个“见鬼”的 bug 折磨了一下午,最后揪出来的凶手,藏在一门八竿子打不着的语言里。
事情是前端同事先找上门的:“你那个接口是不是有毛病?更新订单,接口没报任何异常,可数据回查一看,压根没改成功。”
他的第一反应跟大多数人一样:不可能,后端查出来是什么就返回什么,八成是前端哪里处理岔了。结果 F12 一开 Network 面板,人傻了——接口返回的 orderId 是1784523698741256200,数据库里存的却是1784523698741256193,后端拿着前者去更新,居然还真就不报错。
好家伙,最后三位悄悄变了。更诡异的是,这串数字在 Java 后端日志里打印出来完完全全是正确的,偏偏一到浏览器这边就变了样。
稍微查了一下就水落石出。原来这套系统的主键经历过一次改造:最早用的是 MySQL 自增 id,int 类型;后来为了统一各系统主键,切成了雪花算法生成主键,类型换成 Long。坑就埋在这一步。
JavaScript 的 Number 是双精度浮点数,它能安全表示的最大整数是 2^53 - 1,也就是9007199254740991,16 位。而 Java 的 Long 上限是 2^63 - 1,足足 19 位,远远超出了 JS 能精确表达的范围。
- 雪花 ID 长度普遍在 18~19 位,妥妥超出 Number.MAX_SAFE_INTEGER
- 超出安全范围的 Long 以数字形式写进 JSON,浏览器解析时就会丢精度
- 它既不是后端的 bug,也不是前端的 bug,是 JavaScript 语言本身的限制
所以只要后端把大 Long 当数字返回,前端拿到的就注定是个“变形”的值——这不是谁写错了代码,是两家语言的边界没对齐。
思路其实很直接:后端序列化成 JSON 时,把所有 Long 类型转成字符串。这样 JSON 里就是带引号的字符串,浏览器不会把它当 Number 处理,精度自然不丢。
实现方式有两条路。一种是老老实实给每个 DTO 的 Long 字段加 @JsonSerialize 注解——但项目里几十个实体类,每个类里都可能藏着 Long 字段,一个个加纯属体力活,还容易漏。另一种是全局统一配置,在消息转换器层面一次解决:
他们的项目是继承 WebMvcConfigurationSupport,重写 configureMessageConverters 方法,核心代码就几行:
拆开看就三步:第一步,创建 SimpleModule,注册两条序列化规则——Long.class(包装类型)和 Long.TYPE(基本类型)都得注册,缺一个就会漏;第二步,把它挂到 ObjectMapper 上,Jackson 之后序列化任何 Long 值都会自动转成字符串;第三步,把这个 ObjectMapper 交给消息转换器,加进转换器列表。
这里有个细节值得记一笔:如果你用的是实现 WebMvcConfigurer 接口的方式,configureMessageConverters 里的配置在 Spring Boot 某些版本下行为不太一致,自定义转换器可能被默认转换器覆盖,或者追加顺序不对。他们项目是直接继承 WebMvcConfigurationSupport,优先级更高、配置更可靠。
但代价也得认:继承它之后,Spring Boot 对 WebMvc 的自动配置就不再完全生效,静态资源映射、拦截器这些都得手动配回来:
同一个方法里还顺带处理了两件小事:一是上面代码里的FAIL_ON_UNKNOWN_PROPERTIES 关掉,不然前端多传个字段,Jackson 反序列化直接抛异常,烦死人;二是加了个 StringHttpMessageConverter 并关掉 WriteAcceptCharset,解决访问 actuator/prometheus 接口返回 406 的问题:
重启服务再看接口返回,问题当场现形也当场解决:
前端拿到的是字符串,精度不再丢失,联调一次过。
说实话这个问题不算难,甚至很好复现,但第一次撞上的时候真的容易懵——排查时日志里的值全是对的,偏偏前端拿到的就是错的,一度让人怀疑人生。核心就一句话:JS 的数字装不下 Java 的 Long,让后端序列化成字符串就行。全局配置比逐个加注解优雅得多,一处配置、全项目生效。
你有没有被“日志全对、前端全错”这种 bug 折磨过?评论区聊聊你怀疑人生的那个瞬间
热门跟贴