网易首页 > 网易号 > 正文 申请入驻

日志全对,数据却错了,这个Bug让我怀疑了一下午

0
分享至

一场“数据穿越”的悬案根因: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 折磨过?评论区聊聊你怀疑人生的那个瞬间

声明:内容由AI生成

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
伊拉克总理下令,欠中方的工程款立即结清,只向中方提了一个要求

伊拉克总理下令,欠中方的工程款立即结清,只向中方提了一个要求

墨兰史书
2026-11-17 14:00:04
又投中5个三分!抱歉雷阿伦:你的历史第三要不保了

又投中5个三分!抱歉雷阿伦:你的历史第三要不保了

篮球大视野
2026-11-17 20:36:34
中国女子在希腊失踪半年,警方在保险箱内发现10万现金和神秘十人名单,与其有关的中国房产中介失联,最后监控画面曝光

中国女子在希腊失踪半年,警方在保险箱内发现10万现金和神秘十人名单,与其有关的中国房产中介失联,最后监控画面曝光

台州交通广播
2026-11-17 01:10:51
国足争议判罚!王钰栋遭爆铲,VAR介入8分钟,张玉宁连场破门

国足争议判罚!王钰栋遭爆铲,VAR介入8分钟,张玉宁连场破门

奥拜尔
2026-11-17 21:50:12
突然,直线拉升!英伟达,重磅来袭!

突然,直线拉升!英伟达,重磅来袭!

证券时报
2026-11-17 20:54:06
突发!黄仁勋大反击!

突发!黄仁勋大反击!

财经要参
2026-11-17 07:30:09
突发!美国多家大银行集体崩了。。。

突发!美国多家大银行集体崩了。。。

云头条
2026-11-17 05:07:09
炸了!中国影后与女导演澳洲领证结婚!刷上热搜!二人均未敢回应

炸了!中国影后与女导演澳洲领证结婚!刷上热搜!二人均未敢回应

澳洲红领巾
2026-11-17 11:17:20
北大研究表明:我国最富的20%的家庭获得了55.4%的医保报销,却只付出了7.9%的代价!

北大研究表明:我国最富的20%的家庭获得了55.4%的医保报销,却只付出了7.9%的代价!

黯泉
2026-11-17 19:26:43
甘肃一小县城因“慢生活”走红:只有5辆出租车,视频点赞数超过当地城镇人口

甘肃一小县城因“慢生活”走红:只有5辆出租车,视频点赞数超过当地城镇人口

上游新闻
2026-11-17 14:44:05
终于看懂了!高油价正在复制香烟的涨价套路,老百姓却不玩了!

终于看懂了!高油价正在复制香烟的涨价套路,老百姓却不玩了!

江启
2026-11-17 01:14:38
先挨二记闷棍!俄罗斯导弹袭击基辅南北两座大桥,恰逢北约峰会开会在即

先挨二记闷棍!俄罗斯导弹袭击基辅南北两座大桥,恰逢北约峰会开会在即

军迷战情室
2026-11-17 07:39:35
江苏母亲勒死3岁亲儿,庭审现场道出缘由,孩子生前那句话让人泪崩

江苏母亲勒死3岁亲儿,庭审现场道出缘由,孩子生前那句话让人泪崩

雾岛夜话
2026-11-17 13:25:16
网传蔚来财务暴雷?官方报案!与事实严重不符

网传蔚来财务暴雷?官方报案!与事实严重不符

闪电新闻
2026-11-17 17:49:33
逾3500股飘红!两大板块,多股涨停

逾3500股飘红!两大板块,多股涨停

证券时报
2026-11-17 12:39:44
腾讯发文:已到生死存亡时刻,未来不一定要那么多管理岗位,需要一半人去打新的战役

腾讯发文:已到生死存亡时刻,未来不一定要那么多管理岗位,需要一半人去打新的战役

21世纪经济报道
2026-11-17 07:38:59
浙江一小区内大摆80桌宴席,900多人参加,还有人霸气拿出茅台请客,业主感叹:像吃流水席,明年还要办

浙江一小区内大摆80桌宴席,900多人参加,还有人霸气拿出茅台请客,业主感叹:像吃流水席,明年还要办

大风新闻
2026-11-17 08:52:07
黄乐最新私密照爆出, 难怪黄仁勋把持不住!

黄乐最新私密照爆出, 难怪黄仁勋把持不住!

仕道
2026-11-17 11:11:01
这两天,网友们在围观一个叫玉芬的记者

这两天,网友们在围观一个叫玉芬的记者

清晖有墨
2026-11-17 12:40:13
克里米亚大桥被炸断了!!!

克里米亚大桥被炸断了!!!

西楼饮月
2026-11-17 16:41:46
2026-11-18 00:12:49
千纸鹤安安
千纸鹤安安
大自然的搬运工
208文章数 4关注度
往期回顾 全部

科技要闻

老黄想回来?英伟达董事会:没门

头条要闻

"结婚22年两儿子均非亲生"事件女方发声:我没出轨

头条要闻

"结婚22年两儿子均非亲生"事件女方发声:我没出轨

体育要闻

东契奇心仪之人 三年后拿着底薪站到他身旁

娱乐要闻

刘欢有6位生死之交,个个可托付后事

财经要闻

日本经济再现负增长 日央行12月还加息吗

汽车要闻

红旗H9 PHEV这后排,谁还抢着坐副驾?

态度原创

游戏
教育
家居
手机
时尚

《GTA6》试玩披露野生动物日志 可记录62种鸟类

教育要闻

【预告】11月20日|第152场中小学课堂教学数字化评价与质量提升项目省级教研活动

家居要闻

2026建博会(广州) 公装联探展交流活动

手机要闻

华为Mate XT 2获HarmonyOS 7.0.0.115升级,新增“好心人救援”功能

秋天衣服别总穿纯色,试试这几件条纹单品,简单时尚又减龄

无障碍浏览 进入关怀版