PHP多维数组转一维时float精度丢失的根源在于后续字符串化、输出或错误类型转换（如intval），而非转换本身；应通过指定键名保留小数位（如number_format）、避免array_merge_recursive隐式类型覆盖，并在数据流出环节（如JSON输出前）针对性处理。
PHP 多维数组转一维时 float 精度丢失的根源
PHP 数组序列化或 JSON 编码过程中，float 类型本身在内部以 IEEE 754 双精度表示，但问题往往不出在“转换”本身，而出在后续的字符串化、输出、或错误地用 intval() / (int) 强转 —— 尤其当原始值是 1.20、3.05 这类带末尾零的小数时，PHP 默认格式化会抹掉冗余零，看起来像“精度丢失”，实则是显示/序列化行为。
常见错误现象包括：
- 二维数组里存着
['price' => 29.90]，扁平化后变成 'price' => 29.9
- 用
json_encode() 输出给前端，小数位被截断，导致金额对不上
- 直接
print_r() 或 var_dump() 看不到问题，但入库或 API 返回时暴露
用 array_walk_recursive + 自定义回调保留原始浮点字面量
核心思路：不依赖自动类型转换，把原始数值当作字符串暂存，再按需还原。适用于已知哪些键需要保精度（如 price、rate、amount）的场景。
$keepKeys = ['price', 'amount', 'discount', 'rate'];
$result = [];
array_walk_recursive($data, function($value, $key) use (&$result, $keepKeys) {
if (is_float($value) && in_array($key, $keepKeys)) {
// 用 sprintf 保留原始小数位数（最多两位，不补零）
$result[$key] = sprintf('%.2F', $value);
// 或更稳妥：用 number_format($value, 2, '.', '')
} elseif (!is_array($value)) {
$result[$key] = $value;
}
});
注意：sprintf('%.2F', 29.9) 得到 "29.90"，而 number_format(29.9, 2) 也得 "29.90"；但 sprintf('%.2F', 29.90001) 会四舍五入为 "29.90"，按需选择。
JSON 输出前统一处理浮点字段（避免前端解析误差）
如果最终目标是 API 返回 JSON，且必须保持小数位（比如财务系统），不要依赖前端 JS 的 parseFloat() 或自动解析 —— 它们会把 "29.90" 当字符串，29.90 当数字并可能丢零。
推荐做法：
- 在调用
json_encode() 前，遍历扁平化后的数组，对指定键的 float 值转成带固定小数位的字符串
- 使用
JSON_PRESERVE_ZERO_FRACTION（PHP 7.1+）：仅对 float 值生效，但**不保证小数位数**，只确保带小数点，例如 29.0 → 29.0，但 29.9 还是 29.9
- 更可靠的是手动字符串化：
$data['price'] = number_format($data['price'], 2, '.', '')
二维转一维时避免 array_merge_recursive 的隐式类型覆盖
array_merge_recursive() 在遇到同名数字键时会追加，但遇到同名字符串键且值为数字时，可能触发 PHP 的“自动合并为数组”行为，间接导致 float 被当作 int 处理。
更安全的扁平化方式（尤其含嵌套 numeric key）：
function flattenArray($arr, $prefix = '') {
$result = [];
foreach ($arr as $key => $value) {
$newKey = $prefix === '' ? $key : $prefix . '_' . $key;
if (is_array($value)) {
$result += flattenArray($value, $newKey);
} else {
// 关键：此处不强制类型转换，原样保留
$result[$newKey] = $value;
}
}
return $result;
}
这个函数不会动 $value 的类型，浮点数进来就原样出去。后续再按字段做精度控制，比在扁平过程中就 cast 安全得多。
浮点精度不是“转一维”导致的，而是你在某个环节把它当整数用了、或用默认格式化输出了。盯住数据流出的那一个点 —— 是入库？是 JSON？还是日志打印？—— 针对性加固，比全局改转换逻辑更有效。
['price' => 29.90]，扁平化后变成 'price' => 29.9
json_encode() 输出给前端，小数位被截断，导致金额对不上print_r() 或 var_dump() 看不到问题，但入库或 API 返回时暴露price、rate、amount）的场景。
$keepKeys = ['price', 'amount', 'discount', 'rate'];
$result = [];
array_walk_recursive($data, function($value, $key) use (&$result, $keepKeys) {
if (is_float($value) && in_array($key, $keepKeys)) {
// 用 sprintf 保留原始小数位数（最多两位，不补零）
$result[$key] = sprintf('%.2F', $value);
// 或更稳妥：用 number_format($value, 2, '.', '')
} elseif (!is_array($value)) {
$result[$key] = $value;
}
});
注意：sprintf('%.2F', 29.9) 得到 "29.90"，而 number_format(29.9, 2) 也得 "29.90"；但 sprintf('%.2F', 29.90001) 会四舍五入为 "29.90"，按需选择。
JSON 输出前统一处理浮点字段（避免前端解析误差）
如果最终目标是 API 返回 JSON，且必须保持小数位（比如财务系统），不要依赖前端 JS 的 parseFloat() 或自动解析 —— 它们会把 "29.90" 当字符串，29.90 当数字并可能丢零。
推荐做法：
- 在调用
json_encode() 前，遍历扁平化后的数组，对指定键的 float 值转成带固定小数位的字符串
- 使用
JSON_PRESERVE_ZERO_FRACTION（PHP 7.1+）：仅对 float 值生效，但**不保证小数位数**，只确保带小数点，例如 29.0 → 29.0，但 29.9 还是 29.9
- 更可靠的是手动字符串化：
$data['price'] = number_format($data['price'], 2, '.', '')
二维转一维时避免 array_merge_recursive 的隐式类型覆盖
array_merge_recursive() 在遇到同名数字键时会追加，但遇到同名字符串键且值为数字时，可能触发 PHP 的“自动合并为数组”行为，间接导致 float 被当作 int 处理。
更安全的扁平化方式（尤其含嵌套 numeric key）：
function flattenArray($arr, $prefix = '') {
$result = [];
foreach ($arr as $key => $value) {
$newKey = $prefix === '' ? $key : $prefix . '_' . $key;
if (is_array($value)) {
$result += flattenArray($value, $newKey);
} else {
// 关键：此处不强制类型转换，原样保留
$result[$newKey] = $value;
}
}
return $result;
}
这个函数不会动 $value 的类型，浮点数进来就原样出去。后续再按字段做精度控制，比在扁平过程中就 cast 安全得多。
浮点精度不是“转一维”导致的，而是你在某个环节把它当整数用了、或用默认格式化输出了。盯住数据流出的那一个点 —— 是入库？是 JSON？还是日志打印？—— 针对性加固，比全局改转换逻辑更有效。
json_encode() 前，遍历扁平化后的数组，对指定键的 float 值转成带固定小数位的字符串JSON_PRESERVE_ZERO_FRACTION（PHP 7.1+）：仅对 float 值生效，但**不保证小数位数**，只确保带小数点，例如 29.0 → 29.0，但 29.9 还是 29.9
$data['price'] = number_format($data['price'], 2, '.', '')
array_merge_recursive() 在遇到同名数字键时会追加，但遇到同名字符串键且值为数字时，可能触发 PHP 的“自动合并为数组”行为，间接导致 float 被当作 int 处理。
更安全的扁平化方式（尤其含嵌套 numeric key）：
function flattenArray($arr, $prefix = '') {
$result = [];
foreach ($arr as $key => $value) {
$newKey = $prefix === '' ? $key : $prefix . '_' . $key;
if (is_array($value)) {
$result += flattenArray($value, $newKey);
} else {
// 关键：此处不强制类型转换，原样保留
$result[$newKey] = $value;
}
}
return $result;
}
这个函数不会动 $value 的类型，浮点数进来就原样出去。后续再按字段做精度控制，比在扁平过程中就 cast 安全得多。
浮点精度不是“转一维”导致的，而是你在某个环节把它当整数用了、或用默认格式化输出了。盯住数据流出的那一个点 —— 是入库？是 JSON？还是日志打印？—— 针对性加固，比全局改转换逻辑更有效。
