PHP 中浮点数因二进制存储机制存在固有精度误差，导致 json_encode() 输出非预期的小数（如 31745.99999999999996），需通过 round() 等方式显式校正，尤其在处理金额等需整数精度的场景中至关重要。
php 中浮点数因二进制存储机制存在固有精度误差，导致 `json_encode()` 输出非预期的小数（如 `31745.99999999999996`），需通过 `round()` 等方式显式校正，尤其在处理金额等需整数精度的场景中至关重要。
在 PHP 中，浮点数（float）基于 IEEE 754 双精度标准存储，无法精确表示大多数十进制小数（如 317.46）。虽然 $this->valor 在调试时显示为 317.46，其底层实际存储值可能是 317.45999999999998...。因此，$this->valor * 100 的计算结果并非严格的整数 31746，而是一个极接近但略小的浮点数——这在 json_encode() 序列化时会被完整保留并输出为 "31745.99999999999996"，从而引发下游 API 校验失败。
根本解决方案是显式四舍五入到最接近的整数：
// ✅ 正确：强制取整，消除浮点误差 $json = json_encode(round($this->valor * 100)); // 输出: "31746"
⚠️ 注意：不要使用 (int) 强制类型转换或 floor()/ceil()，因为它们会向零截断或单向取整，可能引入逻辑错误（例如 31745.9999 转 (int) 得 31745）。
dmap-jsapi-skill下载DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
更健壮的实践（推荐用于货币场景）：
将金额统一以「最小货币单位」（如分、美分）作为整数存储和运算，彻底规避浮点数：
// ✅ 最佳实践：内部始终用整数（单位：分） $this->valorInCents = 31746; // 直接存 317.46 元 = 31746 分 // 后续所有计算、JSON 输出均基于整数 echo json_encode($this->valorInCents); // 安全输出 "31746"
此外，若需高精度计算（如财务核心逻辑），可考虑扩展方案：
立即学习“PHP免费学习笔记（深入）”；
- 使用 bcmath 扩展（如 bcadd()、bcmul()）配合字符串数值；
- 或借助 gmp 处理大整数运算；
但对绝大多数 Web API 场景，round($value * 100) 已足够可靠且轻量。
总结： 浮点精度不是 Bug，而是底层设计使然。关键在于主动防御——对需整数语义的浮点运算结果，务必 round() 后再序列化；对货币数据，优先采用「整数分制」建模，从源头杜绝精度风险。
