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 能表示的范围。
如果后端返回：
{"id": 9223372036854775807
}
前端打印可能是：
console.log(data.id); // 输出 9223372036854776000（精度已丢失）
解决方案
方法一：全局配置 Jackson 将 Long 转为 String（推荐）
在 Spring Boot 项目中，可以通过配置 ObjectMapper，让所有 Long 类型序列化为 String，避免精度问题：
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 {@Beanpublic 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，可在字段上添加注解：
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 | ✅ 强烈推荐 | 统一、安全 |
| 局部字段注解 | ✅ 适用于个别字段 | |
| 仅前端处理 | ❌ 不推荐 | 精度可能已丢失，无法挽回 |