hyperf 中更新字段为 null 必须显式处理，因 pdo 默认不将 php null 转为 sql null，model::update() 会跳过 null 字段；稳妥写法是使用 raw('null') 或确保字段允许 null 并通过 db::update() 绑定 pdo::param_null。
Hyperf 项目里用 MySQL 更新字段为 NULL，不是“写个 NULL 就完事”，而是得看你是真想设空，还是误把空字符串、0 或未传值当成了空——稍不注意，UPDATE 就静默失败或写进错误值。
Hyperf 中更新字段为 NULL 的实际写法
Hyperf 默认使用 PDO，不自动将 PHP null 转成 SQL NULL；它更倾向把 null 当作未设置字段跳过，或转成空字符串/0（取决于类型绑定和模型配置）。
- 直接在
update方法里传null值，Hyperf 通常会忽略该字段（尤其在Model::update()中），除非你显式声明要更新 - 想真正写入
NULL，必须用原生 SQL 或 QueryBuilder 的set()显式赋值：$query->where('id', 1)->update(['status' => null])在某些版本下仍可能被过滤，稳妥做法是：$query->set('status', new Raw('NULL'))->where('id', 1)->update() - 使用
Db::update()时，['name' => null]会被 PDO 绑定为PDO::PARAM_NULL，但前提是字段允许NULL且没被模型层拦截
更新前判断字段是否真该设为 NULL
常见误区：前端传了空字符串 '' 或数字 0，后端没校验就直接塞进 update，结果把业务上“清空联系方式”变成了“存了个空字符串”，而数据库里 NULL 和 '' 完全不是一回事。
- PHP 层先做清洗：
trim($data['phone']) === '' ? null : $data['phone']，再传给更新逻辑 - 别依赖 MySQL 的
IFNULL或触发器来“事后修正”，Hyperf 是应用层，该拦的要在进 DB 前拦住 - 如果字段定义为
NOT NULL DEFAULT ''，那它根本不能存NULL，强行写会报错Column 'xxx' cannot be null
用 COALESCE / IFNULL 处理查询时的 NULL 显示
更新是写入动作，但读取时怎么让 NULL 字段友好展示，才是用户真正看到的“空值处理”。Hyperf 查询结果默认保留 NULL，前端渲染容易出错，得在 SQL 层兜底。
- 查单个字段用
IFNULL(name, '未知')，语义清晰、MySQL 原生支持快 - 查多个备选字段（比如优先显示 email，没有就 phone，再没有就 wechat），用
COALESCE(email, phone, wechat, '暂无')，别写三层嵌套IFNULL(IFNULL(...)) - 避免在
WHERE里对函数结果做判断，例如WHERE IFNULL(status, 'draft') = 'draft'—— 这会让status字段索引失效
最易被忽略的一点：Hyperf 的模型自动填充（$fillable）和批量更新（fill() + save()）默认跳过 null 值，哪怕你写了 ['avatar' => null]。真要清空字段，要么用 DB::table()->where()->update() 配 Raw('NULL')，要么在模型里重写 getCasts() 或 serializeDate() 控制行为。
