為什么后端 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	? 強烈推薦	統一、安全
局部字段注解	? 適用于個別字段
僅前端處理	? 不推薦	精度可能已丟失，無法挽回