php json_encode默认丢小数位是因为浮点数在json中不保留格式,且受precision配置影响;需用sprintf等格式化为字符串才能精确控制小数位数。

PHP json_encode 为什么默认会丢小数位
PHP 的 json_encode 在处理浮点数时,会受 serialize_precision 和 precision 这两个 ini 配置影响。默认情况下(PHP 7.1+),serialize_precision 是 -1,看起来“自动”,但实际底层仍按 precision(默认 14)截断有效数字,不是保留小数位数——比如 0.000000000000123456789 可能被转成 1.23456789e-13,再解析回来就失真。
更常见的是:你传入 12.3400,输出变成 12.34,看似“丢了零”,其实是 JSON 规范不区分 12.34 和 12.3400,而 PHP 序列化时做了最简表示。
用 JSON_PRESERVE_ZERO_FRACTION 强制保留小数点后零
这个 flag 只对整数无效,对浮点数生效,但它真正作用是:让 Float 类型即使值为整数(如 12.0),也强制输出带 .0;它 不 控制小数位数精度,也不防止科学计数法。
- 仅适用于 PHP ≥ 7.1
- 必须配合
float类型变量,不能靠字符串伪装 - 对
12.3400这种输入,PHP 已在解析阶段丢掉末尾零(因为 float 本身不存“格式”)
json_encode(['price' => 12.3400], JSON_PRESERVE_ZERO_FRACTION); // 输出:{"price":12.34} —— 没用,还是被简化了 json_encode(['price' => 12.0], JSON_PRESERVE_ZERO_FRACTION); // 输出:{"price":12.0} —— 这个才生效
真正保留小数位数:必须用字符串 + 显式格式化
JSON 本身不支持“精度元信息”,要确保下游(JS、数据库、其他服务)拿到固定小数位,唯一可靠方式是:在 PHP 层把数字格式化为字符串,并确保它确实是你要的字符形式。
立即学习“PHP免费学习笔记(深入)”;
$price = 12.3400; json_encode(['price' => sprintf('%.4f', $price)]); // 输出:{"price":"12.3400"}
-
sprintf('%.4f', 12.3)→"12.3000"(补零) -
sprintf('%.4f', 12.3456789)→"12.3457"(四舍五入) - 若需截断而非四舍五入,得先
floor($x * 10000) / 10000再格式化
注意 json_decode 的反向陷阱
前端或第三方返回的 JSON 字符串,如果含高精度数字(如 "12.345678901234567"),PHP 默认用 json_decode($json, true) 会转成 float,立刻丢失精度(尤其 > 2^53 的整数或超长小数)。
- 必须加
JSON_BIGINT_AS_STRING处理大整数,但对小数无效 - 小数精度保全唯一办法:用
json_decode($json, true, 512, JSON_OBJECT_AS_ARRAY)+ 手动遍历,把数字字段识别为字符串再转——不现实 - 更可行的是:约定上游传字符串,或自己用正则/AST 解析原始 JSON 字符串提取关键字段
真正的难点不在怎么 encode,而在整个链路是否一致把“精度”当作业务契约来维护——从数据库字段类型(DECIMAL(10,4))、API 输入校验、到 JSON 输出格式,缺一不可。