列表能打开,点进详情却查不到记录。对照一下请求,传回去的 ID 和数据库里的 ID 只差了末尾一位。遇到这种情况,先沿着响应走一遍,看看数字究竟在哪一步变了。
如果 Java 端拿到的值正确,响应原文也正确,而 JavaScript 对象里的值已经不同,排查重点就该放在数字解析上。换一次数据库字段类型,未必碰得到问题发生的位置。
下面按 JDK 17、Jackson 2.17.2 和 JavaScript 默认的 JSON.parse 说明。Java 示例适用于使用 Jackson 2.x 的 Spring Boot 3.x 项目;项目换过 JSON 库、消息转换器或序列化规则时,以实际使用的实现为准。
先看响应原文,再看解析后的值
在浏览器开发者工具的 Network 中找到这次请求,查看响应原文,而不是只看已经解析、格式化后的对象。然后在 JavaScript 里对照 id 的值和类型。
下面这段可以单独在浏览器控制台或 Node.js 里运行:
const raw = '{"id":9007199254740993,"count":2}';
const data = JSON.parse(raw);
console.log(raw);
console.log(data.id); // 9007199254740992
console.log(typeof data.id); // number
console.log(Number.isSafeInteger(data.id)); // false
console.log(String(data.id)); // "9007199254740992"
原始文本里明明写的是 9007199254740993,默认解析后却成了 9007199254740992。这时再调用 String(data.id),只是把已经变过的数字转成字符串,原来的末位不会因此回来。
普通 JSON 数字经默认 JSON.parse 解析后对应 JavaScript 的 Number。定位时要把原始响应文本和解析后的值分开看,控制台里展开一个对象不能替代这两步对照。ECMAScript 的 JSON.parse 规则
Java 的 Long 和前端的 Number 不是同一个范围
Java 的 long 是有符号 64 位整数,最大值是 9223372036854775807。前面的演示 ID 在这个范围里,Java 可以准确保存它。JDK 17 的 Long 范围
JavaScript Number 的最大安全整数则是 9007199254740991,也就是 2^53 - 1。超过安全整数范围后,不保证每个整数都能被准确表示,也不保证相邻整数还能区分。不是所有超出范围的数都会立刻显示成另一个值,但拿它承载需要逐位保持的 ID 就不稳妥了。Number.MAX_SAFE_INTEGER
JSON 文本允许写数字,不等于所有接收端都按 Java Long 的方式保存它。JSON 标准也明确提到了常见实现之间能够精确互通的整数范围。RFC 8259 的数字互通说明
这也是为什么某个接口用小 ID 测试时一直正常,换成较长的 ID 才暴露问题。验收时要按真实取值范围准备样例,不能只用 1、2、3 判断链路没问题。
在响应 DTO 上把 ID 写成字符串
如果 ID 只是用于标识、查询和传递,不需要参与前端算术,接口可以把它约定成字符串。对于 Jackson 2.x,可以在响应 DTO 的相应属性上声明字符串形态,保持 Java 内部的 Long 类型。
把下面的类放到已经引入 Jackson databind 的练习项目里,用 IDE 运行 main。它分别输出未处理的响应、按字符串输出 ID 的响应,以及 ID 为 null 的响应。
import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.databind.ObjectMapper;
public class LongIdProbe {
public record NumericResponse(Long id, int count) {}
public record UserResponse(
@JsonFormat(shape = JsonFormat.Shape.STRING) Long id,
int count
) {}
public static void main(String[] args) throws Exception {
var mapper = new ObjectMapper();
long id = 9_007_199_254_740_993L;
System.out.println(mapper.writeValueAsString(
new NumericResponse(id, 2)
));
System.out.println(mapper.writeValueAsString(
new UserResponse(id, 2)
));
System.out.println(mapper.writeValueAsString(
new UserResponse(null, 2)
));
}
}
第一行的 id 没有引号,第二行变成 "id":"9007199254740993"。count 仍然是数字 2;第三行中的 ID 仍为 JSON null,不是字符串 "null"。
@JsonFormat 用于声明序列化形态,具体效果取决于类型和实际序列化器。这里的属性标注已按 Jackson 2.17.2 运行核对,不能仅凭项目里出现过这个注解就认定 HTTP 响应一定已经改变。Jackson 的 JsonFormat 定义
放回 Spring Boot 后,还要确认 Controller 返回的确实是这个 DTO,以及 HTTP 消息转换器是否使用这套 Jackson 配置。若返回的是另一个 VO、已经拼好的 JSON 字符串,或者自定义序列化器覆盖了属性规则,刚才修改的类可能根本没参与响应。
这里应按字段含义约定类型。ID 可以是字符串,页码、数量等字段继续按自身契约处理;已有客户端依赖数值 ID 时,需要协调接口版本与调用方。独立示例中的 ObjectMapper 也不能替代项目真实响应的核对。DTO 的使用位置可以对照 Spring Boot 统一返回结果。
往回传时也别把它转回 Number
接口改成字符串后,继续追到下一次请求。表格行数据、路由参数、表单状态和请求封装都可能经过类型转换。只要中间又调用了 Number(id)、parseInt(id, 10),就可能重新走回精度受限的数值路径。
下面仍是独立的 JavaScript 示例,ID 从解析到构造请求都保持字符串:
const response = JSON.parse('{"id":"9007199254740993","count":2}');
console.log(response.id); // "9007199254740993"
console.log(typeof response.id); // string
console.log(typeof response.count); // number
const payload = JSON.stringify({ id: response.id });
console.log(payload); // {"id":"9007199254740993"}
请求端按接口约定携带字符串,服务端再按约定校验和解析。别一边把响应 ID 定义成字符串,另一边的前端类型、请求 DTO 或接口文档还写着另一种约定。
还要区分“值正确,类型不同”和“值已经丢位”。例如字符串 ID 和数字 ID 拿去做比较、作为 Map 的键,可能出现类型不一致的问题;它与数字本身被舍入是两件事。可以结合 Stream 转 Map 的 key 排查 检查整条链路的标识定义。
复测时,把同一个 ID 沿五个位置对一次:Java DTO、HTTP 响应原文、解析后的对象、页面状态、下一次请求原文。同时放入一个安全范围内的 ID、一个超出安全范围的 ID,以及契约允许的 null;既看每一位,也看实际类型。
文中的 Java 与 JavaScript 示例已在本机编译、运行,并用 Java 输出的 JSON 做了解析对照;没有据此声称完整 Spring Boot 接口或业务页面已通过验收。真正需要确认的是,业务链路里的同一个 ID 从发出到传回,始终没有变成另一个值。
Java 返回的 Long ID,到了前端怎么变了
https://java.li/archives/java-long-id-javascript-precision
评论