Laravel 的 JSON 字段在空输入时默认存为 [null] 而非 NULL，导致 whereNotNull() 失效；本文详解如何通过模型层预处理、数据库约束及查询优化，实现语义清晰的空值管理。
laravel 的 json 字段在空输入时默认存为 `[null]` 而非 `null`，导致 `wherenotnull()` 失效；本文详解如何通过模型层预处理、数据库约束及查询优化，实现语义清晰的空值管理。
在 Laravel 中使用 json 类型字段（如 email_signature）时，若前端未提交数据或提交了空数组/空字符串，配合 'array' 类型转换后，Eloquent 默认会将空值序列化为 [null]（即 JSON 数组含一个 null 元素），而非数据库意义上的 NULL 值。这破坏了数据语义一致性——我们期望“无签名”对应 NULL，而非“签名内容为一个 null 元素的数组”。
✅ 推荐解决方案：模型层预处理 + 显式空值归一化
在模型的 setEmailSignatureAttribute 访问器中统一处理空值，确保仅当数据为有效非空结构时才赋值，否则显式设为 null：
// 在 System 模型中
protected $casts = [
'email_signature' => 'array'
];
protected function setEmailSignatureAttribute($value)
{
// 若为 null、空数组、空字符串、或仅含 null 的数组，统一转为 null
if ($value === null || $value === [] || $value === '' || ($value === [null])) {
$this->attributes['email_signature'] = null;
return;
}
// 可选：过滤掉无效项（如 null 元素），避免意外存入 [null, 'text']
if (is_array($value)) {
$cleaned = array_filter($value, fn($v) => $v !== null);
$this->attributes['email_signature'] = empty($cleaned) ? null : $cleaned;
return;
}
$this->attributes['email_signature'] = $value;
}
如此，控制器代码保持简洁：
$system->email_signature = $request->input('email_signature'); // 自动归一化
$system->save();
? 查询时安全判断“真正为空”
-
✅ 查
NULL值（推荐）：
jm-jsjkxyjs02-zlm-405下载使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
System::whereNull('email_signature')->get(); // 精准匹配数据库 NULL ⚠️ 避免
whereNotNull()误判：whereNotNull('email_signature')仍会命中[null]（因该字段非 NULL），故不适用于此场景。-
? 若遗留数据含
[null]，需清理并迁移：// 一次性修复（运行于 Artisan 命令或迁移中） System::whereRaw("email_signature = '[null]'")->update(['email_signature' => null]);
? 补充建议
-
数据库约束强化：在迁移中添加检查约束（PostgreSQL）或触发器（MySQL），拒绝
[null]类似非法值； -
API 响应一致性：在
toArray()或 API Resource 中，对email_signature为null时返回null，而非空数组，保障前后端契约清晰； -
测试覆盖：验证
null、[]、[null]、['text']四种输入均被正确归一化或保留。
通过访问器主动控制赋值逻辑，你不仅能彻底规避 [null] 异常存储，还能让查询语义回归直觉——whereNull() 即“无签名”，干净、高效、可维护。
