You need to enable JavaScript to run this app. PHPUnit 断言MySQL存储JSON字段因序列化空格差异失败
优惠活动
大模型
产品
解决方案
定价
更多

PHPUnit 断言MySQL存储JSON字段因序列化空格差异失败

问题根因

你遇到的断言失败完全是MySQL JSON字段的标准化存储逻辑导致的,和你store方法的编码逻辑无关:

  • PHP原生json_encode()默认生成无冗余空格的紧凑JSON文本,比如["1","2"]
  • MySQL的JSON类型字段不会原样存储你传入的文本,而是会先把输入解析为原生JSON结构,再按照自身的序列化规则标准化存储,规则里会在逗号、冒号等结构分隔符后自动添加一个半角空格,最终存为["1", "2"]格式。

JSON规范本身只要求结构合法,对分隔符周边的空格数量没有强制约束,两种格式的JSON解析后是完全等价的。你现在的断言是直接对比JSON字符串的纯文本内容,哪怕两边的JSON结构完全一致,也会因为分隔符后的空格差异触发断言失败,本质上是把数据库的内部存储格式当成了需要校验的业务逻辑,方向出现了偏差。

解决方案

方案1:绕开文本对比,直接校验JSON解析后的结构(最推荐)

测试的核心目标是确认存入数据库的JSON结构和预期一致,不是确认数据库存储的文本格式和PHP本地生成的字符串完全相同。直接把两边的JSON字符串解码为PHP数组再做对比,就可以完全屏蔽存储格式的差异:

$product = Product::find(1);
// 单独对比JSON类型字段的结构
$this->assertEquals(
    json_decode($productExpected->size, true),
    json_decode($product->size, true)
);
$this->assertEquals(
    json_decode($productExpected->color, true),
    json_decode($product->color, true)
);
// 非JSON类型的普通字段,依然可以直接对比原始属性

方案2:在Eloquent模型中配置JSON字段类型转换(框架环境下的最佳实践)

如果你使用Laravel/Eloquent框架,根本不需要手动调用json_encode处理JSON字段。直接在Product模型中定义字段类型转换规则:

// Product 模型类内
protected $casts = [
    'size' => 'array',
    'color' => 'array',
];

配置完成后,Eloquent会自动帮你完成全流程的编解码:

  • 写入数据库时,自动把传入的PHP数组编码为兼容MySQL的JSON格式
  • 从数据库取出时,自动把JSON内容解析回原生PHP数组
    这时候你拿到的$product->size、$product->color本身就是PHP数组,直接对比数组相等即可,完全不需要额外的编解码步骤,也不会受数据库存储格式的影响。

不推荐的方案:硬编码匹配MySQL的文本格式

如果你非要强求字符串文本完全一致,也可以手动调整预期值的格式,比如把生成的紧凑JSON的逗号后加上空格匹配MySQL的存储格式,但这种方式非常脆弱:

  • MySQL不同版本的JSON序列化细节可能存在差异
  • 后续如果数据库版本升级、序列化规则调整,测试会无意义的失败
    本质上是把数据库的内部实现细节绑死在测试用例里,维护成本极高。
避坑提醒

不要直接通过两个模型的getAttributes()返回值做全量相等断言,JSON字段、时间字段这类存在内部格式自动转换的字段,都会因为数据库/框架的自动处理出现非业务性的文本差异,拆分字段做针对性的结构校验才是合理的测试逻辑。


内容的提问来源于stack exchange,提问作者user1904731

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 22:45:04