Java 后端给前端传Long值,精度丢失的问题与解决

为什么后端 Long 类型 ID 要转为 String?

在前后端分离的开发中,Java 后端通常使用 Long 类型作为主键 ID(如雪花算法生成的 ID)。但如果直接将 Long 返回给前端,可能会导致前端精度丢失的问题,特别是在 JavaScript 环境中。


问题本质

JavaScript 的 Number 类型基于 IEEE 754 双精度浮点数只能安全表示的整数范围是:

复制代码
[-2^53 + 1, 2^53 - 1] => [-9007199254740991, 9007199254740991]

而 Java 的 Long 最大值是 9223372036854775807,远超 JS 能表示的范围。

如果后端返回:

json 复制代码
{
  "id": 9223372036854775807
}

前端打印可能是:

js 复制代码
console.log(data.id); // 输出 9223372036854776000(精度已丢失)

解决方案

方法一:全局配置 Jackson 将 Long 转为 String(推荐)

在 Spring Boot 项目中,可以通过配置 ObjectMapper,让所有 Long 类型序列化为 String,避免精度问题:

java 复制代码
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule simpleModule = new SimpleModule();
        // Long 和 long 全部转为字符串
        simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
        simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
        objectMapper.registerModule(simpleModule);
        return objectMapper;
    }
}

💡 生效后,所有 Long 类型字段将自动序列化为字符串,前端拿到的 ID 是 "9223372036854775807",避免精度问题。


方法二:仅对单个字段生效(局部注解)

如果你只想对部分字段(如 id)转为 String,可在字段上添加注解:

java 复制代码
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;

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

    // 其他字段...
}

方法三:前端处理(不推荐)

虽然前端可以用字符串处理 ID,但如果后端返回的是数字,JS 在接收数据的第一步就已经丢了精度。因此根本的解决方式应该在后端。


总结

方式 是否推荐 说明
后端全局转 String ✅ 强烈推荐 统一、安全
局部字段注解 ✅ 适用于个别字段
仅前端处理 ❌ 不推荐 精度可能已丢失,无法挽回
相关推荐
CodeSheep7 分钟前
小米汽车这薪资是认真的吗?
前端·后端·程序员
今天背单词了吗98010 分钟前
算法学习笔记:8.Bellman-Ford 算法——从原理到实战,涵盖 LeetCode 与考研 408 例题
java·开发语言·后端·算法·最短路径问题
白白李媛媛12 分钟前
上传Vue3+vite+Ts组件到npm官方库保姆级教程
前端·arcgis·npm
天天摸鱼的java工程师13 分钟前
使用 Spring Boot 整合高德地图实现路线规划功能
java·后端
晴殇i21 分钟前
前端内容保护:如何有效防止用户复制页面内容?
前端·javascript·css
程序猿阿伟25 分钟前
《声音的变形记:Web Audio API的实时特效法则》
开发语言·前端·php
东阳马生架构28 分钟前
订单初版—2.生单链路中的技术问题说明文档
java
凌览29 分钟前
有了 25k Star 的MediaCrawler爬虫库加持,三分钟搞定某红书、某音等平台爬取!
前端·后端·python
万少31 分钟前
2-自然壁纸实战教程-AGC 新建项目
前端·harmonyos
满分观察网友z42 分钟前
别小看这个滑动条!从性能灾难到用户挚爱的 uni-app Slider 踩坑实录
前端