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 ✅ 强烈推荐 统一、安全
局部字段注解 ✅ 适用于个别字段
仅前端处理 ❌ 不推荐 精度可能已丢失,无法挽回
相关推荐
摸鱼仙人~1 小时前
styled-components:现代React样式解决方案
前端·react.js·前端框架
kangkang-1 小时前
PC端基于SpringBoot架构控制无人机(三):系统架构设计
java·架构·无人机
sasaraku.1 小时前
serviceWorker缓存资源
前端
RadiumAg3 小时前
记一道有趣的面试题
前端·javascript
yangzhi_emo3 小时前
ES6笔记2
开发语言·前端·javascript
界面开发小八哥3 小时前
「Java EE开发指南」如何用MyEclipse创建一个WEB项目?(三)
java·ide·java-ee·myeclipse
yanlele3 小时前
我用爬虫抓取了 25 年 5 月掘金热门面试文章
前端·javascript·面试
idolyXyz3 小时前
[java: Cleaner]-一文述之
java
一碗谦谦粉3 小时前
Maven 依赖调解的两大原则
java·maven
netyeaxi4 小时前
Java:使用spring-boot + mybatis如何打印SQL日志?
java·spring·mybatis