這是一個真實踩過的坑:後台有個腳本功能,可以編寫腳本動態調用 Java 代碼,結果一個角色 ID 傳過去之後竟然少了 1。
原本的腳本長這樣:
importClass(com.ztgame.center.controller.api, P360ApiController); var roleId = 10214734953631045; p360ApiController.notice(roleId, 4);
腳本執行成功,沒有任何報錯,但目標玩家並沒有收到郵件。翻查日誌才發現端倪:
recharge award has been sent. roleId=10214734953631044;
尾數從 5 變成了 4,剛好差 1。
這是典型的 JavaScript 精度問題。JavaScript 只有一個數字型別(IEEE 754 雙精度浮點數),能安全表示的整數範圍有限——整數部分最多約 15 位有效數字,小數最大精度是 17 位,而且浮點運算並不總是百分之百準確。
把腳本改寫一下就能親眼看到:
var roleId = 10214734953631045; var output = roleId;
輸出結果是:
1.0214734953631044E16
也就是說,數字在賦值的那一刻就已經被捨入了。這不是 JavaScript 的錯,也不是 Java 的錯——後續轉成 Long 型別時拿到的確實就是 10214734953631044。
思路很單純:既然數字會失真,那就別讓它當數字。撰寫一個通用轉換方法,把角色 ID 以字串形式傳進 JavaScriptEngine:
importClass(com.ztgame.common.util.StringKit); importClass(com.ztgame.center.controller.api, P360ApiController); // 關鍵:加上引號,宣告為字串 var roleId = "10214734953631045";
這樣 JavaScriptEngine 拿到的就是字串,真正的型別轉換交給 Java 去做:
p360ApiController.notice(StringKit.parseLong(roleId), 4);
執行成功,ID 一位都沒少。
這個坑不只出現在腳本引擎裡。凡是後端把 64 位 ID(雪花演算法生成的 ID、大額交易序號等)以 JSON 數字形式丟給前端,前端一旦用 JSON.parse 解析就可能悄悄改動尾數。常見的應對方式有三種:後端直接輸出字串、前端使用 JSONbig 這類保留精度的解析庫,或者約定所有 ID 一律以字串傳遞。养成「ID 就是字串」的習慣,能省下不少排查時間。