PHP json_encode 空数组序列化歧义与跨语言兼容解决方案

问题背景：PHP 空数组的类型歧义

在 PHP 中，数组既可作为索引列表（List/Array），也可作为键值对集合（Map/Object）。当执行 json_encode() 时，如果数组包含非整数键，PHP 会将其序列化为 JSON 对象 {}；如果是整数键则为数组 []。

然而，当遇到空数组时，PHP 无法判断其原本意图是“空对象”还是“空列表”，因此采取了保守策略，统一将其序列化为 []。在前端 JavaScript 弱类型环境下，这通常不会造成困扰，但在与 Java、ObjC 等静态类型语言的客户端交互时，类型定义的严格性会导致严重的解析异常。

典型报错场景

假设后端返回的数据结构中，answers 字段定义为映射关系（Map），但当没有答案时为空数组：

$ret1 = [
    'choices' => ['鱼香肉丝', '宫保鸡丁'],
    'answers' => [
        '张三' => 0,
        '李四' => 1,
        '赵云' => 0,
    ],
];

$ret2 = [
    'choices' => [],
    'answers' => [],
];

echo json_encode($ret1, JSON_UNESCAPED_UNICODE) . "\n";
echo json_encode($ret2, JSON_UNESCAPED_UNICODE) . "\n";

输出结果对比：

// ret1 正常序列化，因为 answers 有字符串键，被视为对象
{"choices":["鱼香肉丝","宫保鸡丁"],"answers":{"张三":0,"李四":1,"赵云":0}}

// ret2 出现问题，空的 answers 被序列化成了数组 []
{"choices":[],"answers":[]}

在 Android (Java/Kotlin) 客户端定义 DTO 模型时，通常如下声明：

class ResultDTO {
    lateinit var choices: List<String>
    lateinit var answers: Map<String, Int>
}

当返回 ret2 时，Jackson/Gson 等解析器会发现期望的是 Map（对象），但实际接收到的是 START_ARRAY（数组标记），从而抛出致命错误：

com.fasterxml.jackson.databind.JsonMappingException: 
Can not deserialize instance of java.util.LinkedHashMap out of START_ARRAY token

解决方案：强制指定序列化类型

要解决此问题，核心思路是在 json_encode() 之前，显式地将预期为对象的空数组转换为 PHP 的对象结构，使其在 JSON 编码后生成 {} 而非 []。

方法一：使用 ArrayObject（推荐）

利用 SPL 扩展中的 ArrayObject 类。它既能像数组一样操作，又能在序列化时被识别为标准对象。

$arr = [
    // 常规数组处理
    'choices' => [],
    // 强制指定为对象结构
    'answers' => new \ArrayObject([])
];

$jsonRet = json_encode($arr, JSON_UNESCAPED_UNICODE);
print_r($jsonRet);

效果：生成的 JSON 将变为 {"choices":[],"answers":{}}。客户端解析器能正确识别 answers 为 Map 类型，即使值为空也能顺利注入。
优点：ArrayObject 提供了丰富的数组操作方法，不影响原有业务逻辑编写。

方法二：强制类型转换 (object)

直接使用 PHP 的内建类型转换语法将空数组强制转为 StdClass 对象。

$ret2 = [
    'choices' => [],
    'answers' => (object) [],
];

$jsonRet = json_encode($ret2, JSON_UNESCAPED_UNICODE);

注意：这种方式要求开发者必须清楚哪些字段在 API 契约中定义为“对象/Map”。如果返回值来源复杂且不确定是否为空，需要在 Service 层进行遍历检查并手动转换，增加了维护成本。

总结

PHP 的“万能数组”设计虽然灵活，但在严格类型系统的前端环境（尤其是移动端）中容易引发陷阱。在构建跨语言 RESTful API 时，建议统一遵循以下规范：

• 对于必然返回对象结构的字段，若可能为空，优先使用 (object)[] 或 new ArrayObject([]) 初始化。
• 配合 JSON_UNESCAPED_UNICODE 提升可读性（可选）。
• 确保前端 DTO 定义与后端序列化行为严格一致。

以上就是PHP中json序列化为[]的弊端的详细内容，更多关于PHP json_encode类型处理的资料请关注本站其它相关文章！