PHP json_encode() 将小数转科学计数法是因 zend_print_double() 的精度逻辑,受 serialize_precision 影响;应使用 round() 控制位数或源头保持字符串,避免 sprintf 后编码导致类型错误。
PHP 默认对大于一定位数的浮点数在 json_encode() 时会转成科学计数法(如 1.23e-4),这不是 JSON 规范问题,而是 PHP 内部对浮点数字符串化时的精度控制逻辑导致的。直接转字符串再编码,反而可能破坏数值语义(比如前端无法当数字用),真正要解决的是「让小数以普通十进制字符串形式输出,同时保持 JSON 中仍是 number 类型」。
为什么 json_encode() 会把小数变科学计数法
PHP 的 json_encode() 调用底层 zend_print_double() 格式化浮点数,当指数绝对值 ≥ 5 或小数位数过多(默认受 serialize_precision 影响)时,就会启用科学计数表示。它和 JSON_UNESCAPED_UNICODE 这类标志无关,是数值到字符串转换阶段就定型了。
-
serialize_precisionini 设置(默认 -1)直接影响浮点转字符串的位数,设为17或-1可缓解但不彻底 - 即使
(string)$float看起来正常,json_encode()仍可能重走自己的格式化路径 - 前端 JS 解析
1.23e-4没问题,但某些强类型系统(如 Go 的json.Unmarshal)或调试工具可能显示异常
推荐做法:用 JSON_PRESERVE_ZERO_FRACTION + 控制输入精度
PHP 7.1+ 提供了 JSON_PRESERVE_ZERO_FRACTION 标志,但它只对「整数但带 .0 后缀」有效(如 42.0 → 42.0),对纯小数无效。真正可控的方式是提前将浮点数四舍五入到合理位数,再交给 json_encode():
- 用
round($val, $precision)显式保留小数位(如round(0.000123456, 6)→0.000123) - 避免用
sprintf('%.6f', $val)后再json_encode(),否则结果是字符串而非 number 类型 - 如果业务要求必须保留全部原始小数位(如金融场景),应改用字符串字段传输,并在 JSON 中明确标记:
{"amount": "123.000000456789"}
绕过 PHP 浮点处理:手动拼接 JSON 字符串(慎用)
仅当上述方法都不满足、且数据结构极简单时可考虑。本质是跳过 json_encode() 的浮点处理逻辑,自己保证小数格式: