讲师中心 微信公众号
AI工具推荐 视频效率加速

怎么通过 Jackson 的自定义序列化器解决 long 类型 ID 在前端 JavaScript 接收时的精度丢失

小明吖_3163

小明吖_3163

发布时间:2026-04-23 20:02:26

|

636人浏览过

|

来源于php中文网

原创

将long类型序列化为字符串是最稳妥的解法,因JavaScript数字精度限制(±9007199254740991),而Java long最大值远超此范围,直接传数字会导致ID被四舍五入;推荐全局配置Jackson将Long转字符串,或字段级用@JsonSerialize或@JsonFormat注解。

怎么通过 jackson 的自定义序列化器解决 long 类型 id 在前端 javascript 接收时的精度丢失

直接把 long 类型序列化成字符串,是最稳妥、最通用的解法。JavaScript 的 Number 类型只能安全表示 ±9007199254740991 以内的整数,而 Java 的 long 最大值是 9223372036854775807,远超这个范围。只要后端返回的是数字字面量,前端就可能“悄悄四舍五入”,ID 就变了。

全局配置:所有 long 都转字符串(推荐)

适合项目中大量使用分布式 ID(如雪花算法)、且希望统一处理的场景。只需在 Spring Boot 配置类中注册一个 Jackson 模块:

  • 添加 SimpleModule,注册 ToStringSerializer.instance 分别给 Long.class 和 Long.TYPE(即基本类型 long)
  • Spring Boot 4+ 推荐用 @Bean 返回 JacksonModule;Spring Boot 3 可用 @JacksonComponent 或自定义 ObjectMapper
  • 生效后,所有响应中的 long 字段都会变成 JSON 字符串,比如 "id": "1623255766081638402",前端可安全接收和透传

字段级控制:只对特定 ID 字段生效

适合只想保护关键 ID(如 userId、orderId),其他 long(如计数器、时间戳)仍保持数字格式的场景:

精英前端设计-专业版
精英前端设计-专业版

企业级前端设计系统,支持多页面应用、React/Vue组件、品牌一致性与高级动效编排。

下载
  • 在字段上加 @JsonSerialize(using = ToStringSerializer.class),简洁明确
  • 或用更语义化的 @JsonFormat(shape = JsonFormat.Shape.STRING),效果相同,且支持反序列化时自动转回 long
  • 如果需要条件判断(例如仅当值超过安全范围才转字符串),可写自定义序列化器继承 JsonSerializer<long></long>,在 serialize 方法里做逻辑分支

注意前后端配合的关键细节

光改后端还不够,几个容易踩坑的地方得同步处理:

立即学习“Java免费学习笔记(深入)”;

  • 前端拿到字符串 ID 后,调用接口时也应作为字符串传参(比如放在 JSON body 或 query 参数中),避免 JS 自动转 Number 再次丢失
  • 后端接收时,Spring MVC 默认能将字符串参数(@RequestParam 或 @RequestBody DTO 中的 long 字段)自动转为 long,无需额外配置
  • 若用 Feign 或 OpenFeign 调用其他服务,确保对方也做了同样处理,否则跨服务链路仍可能出问题
  • 避免把实体类里的 long id 直接改成 String id——改动大、影响持久层和业务逻辑,不必要

核心就一条:让 long 在 JSON 序列化环节变成字符串,既不改数据模型,也不动前端逻辑,就能彻底绕过 JavaScript 的精度天花板。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2843

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6183

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7110

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6938

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

983

2024.05.22

java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

11977

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

9062

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

7752

2023.07.31

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.4万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn