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	✅ 强烈推荐	统一、安全
局部字段注解	✅ 适用于个别字段
仅前端处理	❌ 不推荐	精度可能已丢失，无法挽回