Doctrine json_array字段配置键顺序异常问题求助

这个问题我之前也碰到过，核心原因是Doctrine的json_array类型在序列化数组时的内部处理逻辑，和原生json_encode的行为存在差异。

为什么会出现顺序变化？ #

Doctrine的json_array类型处理PHP关联数组时，会先将其转换为stdClass对象再执行JSON序列化。而PHP的对象属性在处理过程中会自动按字母顺序排序，这就导致最终存入数据库的JSON键顺序和原数组不一致。而原生json_encode在PHP 7.4+版本中会保留关联数组的插入顺序，所以直接编码不会出现这个问题。

解决方案 #

方案1：改用Doctrine的json字段类型（推荐） #

从Doctrine ORM 2.6版本开始，新增了json类型，它会直接对PHP数组执行json_encode，不会经过额外的对象转换步骤，因此能完美保留原数组的键顺序。

只需要修改你的字段配置：

<field name="config" type="json" />

实体类中的属性依然可以保持数组类型，调用setConfig设置数组后，Doctrine会直接用原生json_encode处理，存储到数据库的JSON键顺序就和原数组完全一致了。

方案2：自定义字段类型（兼容旧版本） #

如果你的项目无法升级到支持json类型的Doctrine版本，可以自定义一个字段类型，继承原json_array但修改序列化逻辑：

use Doctrine\DBAL\Types\JsonArrayType;
use Doctrine\DBAL\Platforms\AbstractPlatform;

class PreservedOrderJsonArrayType extends JsonArrayType
{
    public function convertToDatabaseValue($value, AbstractPlatform $platform)
    {
        if ($value === null) {
            return null;
        }
        // 直接使用json_encode，保留数组顺序
        return json_encode($value, JSON_UNESCAPED_UNICODE);
    }
}

然后在Doctrine配置中注册这个自定义类型：

<types>
    <type name="preserved_json_array" class="Your\Namespace\PreservedOrderJsonArrayType" />
</types>

最后修改字段配置为自定义类型：

<field name="config" type="preserved_json_array" />

注意事项 #

• 确保你的PHP版本在7.4及以上，因为PHP 7.4才开始保证json_encode对关联数组的插入顺序保留。如果是更低版本，即使使用上述方案，也可能无法保证顺序（这是PHP本身的限制）。

内容的提问来源于stack exchange，提问作者Dion Snoeijen