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
相关产品推荐
相关产品推荐

