PHP 数组键为什么会自动变成整数：数字字符串、JSON 对象与数据校验

接口收到一组商品编号后，日志里明明都是字符串，落到 PHP 数组里却出现了整数键。这个变化通常不是 JSON 或数据库偷偷改了数据，而是 PHP 对数组键有自己的转换规则：没有前导加号、格式合法的十进制整数数字字符串，可能会被当成整数键。

先把“键的文本形式”和“键的 PHP 类型”分开检查，再决定是否转成关联数组、保留原始 JSON，或在入口统一校验；不要只看 print_r() 的展示结果。

PHP 数组键的转换边界在哪里

PHP 数组既能当列表，也能当哈希表。字符串键如果是合法的十进制整数表示，PHP 会把它转换成整数；这也是下面两个访问方式都能命中的原因：

 "帽子", "08" => "带前导零", "+8" => "带加号"];

var_dump($items);
var_dump(array_key_exists(8, $items));
var_dump(array_key_exists("8", $items));
var_dump(array_key_exists("08", $items));

实际排查时不要只看 print_r()，它不会把键的类型讲清楚。var_dump() 才能确认键到底是 int(8) 还是 string(8)。尤其要留意“看起来是编号”的字段：订单号、仓库编码和地区代码经常包含前导零，不能一律转整数。

为什么 JSON 对象会把问题带进业务代码

JSON 对象的键本质上是字符串。调用 json_decode() 时，如果第二个参数传入 true，对象会被转换为 PHP 关联数组；这一步方便取值，却也把数组键规则带到了后续校验。

如果业务只关心“编号到名称”的映射，可以在转换后统一规范编号；如果业务必须区分文本键，就不要把原始 JSON 丢掉。更稳妥的做法是同时保留原文和解析结果，解析结果只负责业务读取，原文用于审计、重放或发现上游格式异常。

入口校验要同时检查键和值

不要用 isset() 判断一个键是否存在，因为它在值为 null 时会返回 false。如果字段允许空值，存在性和取值必须拆开：

 $value) {
        $textKey = (string) $key;
        if (!in_array($textKey, $allowed, true)) {
            $errors[] = "不支持的键：{$textKey}";
        }
        if (!is_string($value) || trim($value) === '') {
            $errors[] = "键 {$textKey} 的名称为空";
        }
    }
    return $errors;
}

这里的强制转换只是为了生成统一的错误信息，不代表应该把所有编号改成整数。真正的规则要由字段定义决定：数量、页码可以转整数；商品编码、行政区划码、外部订单号通常应保留字符串。

三个容易误判的检查点

用宽松比较判断键是否相等

in_array($key, $allowed) 默认使用宽松比较，数字字符串和整数可能被当成同一个值。键校验应传入第三个参数 true，并先明确是否允许 PHP 已经转换过的整数键。

把列表和对象混成一种数据

array_is_list() 可以帮助判断数组是否是从零开始连续的列表，但它不能替你判断业务键是否合法。一个包含 0、1、2 的数组可能是列表，也可能只是错误地把编号当成了下标。

为了“看起来统一”直接使用整数

直接转整数会丢掉前导零，也可能让超出整数范围的外部编号发生变化。先定义字段契约，再在入口做转换；已经进入数据库的值则要回查原始请求，确认变化发生在哪一层。

一份可落地的排查清单

1. 在 JSON 解码后立即用 var_dump(array_keys($data)) 记录键的类型。
2. 对编号字段写出允许格式，例如纯数字、固定长度、是否允许前导零。
3. 键存在性使用 array_key_exists()，成员校验使用严格模式。
4. 分别测试 "8"、"08"、"+8" 和一个带字母的键，确认测试覆盖边界。
5. 把原始 JSON 放进受控日志或审计字段，避免只剩转换后的数组无法追溯。

常见问题

PHP 会把所有数字字符串键都转成整数吗？

不会。是否转换取决于字符串是否符合 PHP 数组键的整数表示规则，前导零、加号和非数字内容都应单独测试。

json_decode 的第二个参数应该总是 true 吗？

不是。需要对象语义和明确属性时可以保留对象；只有在确实需要数组操作、并且已经设计好键规则时，才使用关联数组模式。

如何保留前导零的编号？

把它当字符串处理，并在入口校验长度和字符集；不要先转整数再补零，因为那会掩盖上游传错格式的问题。

为什么 isset($data['x']) 判断不到字段？

当字段存在但值是 null 时，isset() 返回 false。需要区分“字段不存在”和“字段值为空”时，应使用 array_key_exists()。

小结

PHP 数组键的自动转换不是偶发 bug，而是数组类型规则与业务编号语义碰在了一起。把 JSON 解码、键类型确认、字段白名单和严格比较放在同一条入口校验链上，才能知道数据是在解析、映射还是存储时发生了变化。