這是一個真實線上事故的完整記錄:一個 17 位的角色 ID 傳到 Java 端後變成了不一樣的數字,導致郵件發錯對象。問題根源不在 Java,也不在 JavaScript 的實現,而在於 IEEE 754 雙精度浮點的表示能力。
後台提供了一個腳本功能,可以編寫腳本動態調用 Java 代碼:
importClass(com.ztgame.center.controller.api, P360ApiController); var roleId = 10214734953631045; p360ApiController.notice(roleId, 4);
腳本執行成功,沒有任何報錯,但運行結果與設定不符——目標玩家沒有收到郵件。
查看日志:recharge award has been sent. roleId=10214734953631044;
角色 ID 末尾少了一位,...045 變成了 ...044。
懷疑是精度問題,先驗證一下:
var roleId = 10214734953631045; var output = roleId;
輸出結果:1.0214734953631044E16
數字在賦值的那一刻就已經變了。原因在於 JavaScript 只有一個數字類型 Number,它遵循 IEEE 754 雙精度浮點標準,尾數部分只有 52 位,加上隱含的前導 1 共 53 位有效二進制位。
換算成十進制:2^53 = 9007199254740992。這意味著整數精確表示的範圍是 -2^53 到 2^53 之間,約為 16 位十進制數字。而我們的角色 ID 是 17 位,超出了這個範圍,只能被舍入到「最接近的可表示值」,於是末位發生偏移。
所以這既不是 JavaScript 的錯,也不是 Java 的錯。轉成 Long 型之後拿到 10214734953631044,只是忠實反映了 JS 傳過來的錯誤值。垃圾進,垃圾出。
一個自然的念頭是:JS 控制台裡輸入的都是字符串,能不能讓 JS 傳字符串過去,再由 Java 調用 Integer.valueOf 或 Long.valueOf 轉換?答案是可行的,這正是下面的解法。
關鍵原則是讓大整數在離開字符串形態之前,永遠不進入 JavaScript 的 Number 類型。
importClass(com.ztgame.common.util.StringKit); importClass(com.ztgame.center.controller.api, P360ApiController);
把聲明改成字符串形式:
var roleId = "10214734953631045";
這樣 JavaScript 引擎交給 Java 的就是一個完整的字符串,中間不經歷任何數值轉換。真正的解析工作交給 Java 完成:
p360ApiController.notice(StringKit.parseLong(roleId), 4);
執行成功,問題解決。
凡是超過 2^53 的整數 ID,在 JavaScript 裡都不能用 Number 存。常見的高危字段包括:雪花算法生成的分布式 ID、微信/支付類接口的 mch_id 與 openid 相關數值、部分數據庫的 bigint 主鍵、身分證號、銀行卡號。
實務上有幾條防護原則:
後端接口約定用字符串傳輸大整數。這是最根本的做法,前後端都按字符串處理,直到真正需要計算時才轉換。有些團隊會在 JSON 序列化時全局註冊自定義序列化器,把 Long 自動輸出為字符串。
前端不要對 ID 做算術運算。如果業務確實需要(比如分頁計算),改用 BigInt(ES2020 標準,寫法 10214734953631045n)或引入 bignumber.js 這類庫。
警惕 JSON.parse 的隱形轉換。JSON.parse('{"id": 10214734953631045}') 會靜默地丟精度且不報錯,這是最危險的一種情況。防護辦法是先用正則把大數字加上引號,或使用 json-bigint 之類的解析庫。
判斷是否安全可用一個簡單表達式:Number.isSafeInteger(n)(ES6 提供),它會檢查該值是否落在精確整數範圍內。
這次事故最值得記取的教訓是:數字精度問題不會拋出任何錯誤,它靜默地給你一個錯的值。因此對 ID 這類標識性數據,永遠不要假設它「看起來正常」就是正確的。