← 全部技能

软删表上的唯一约束

被删的行仍然占着唯一键。用生成列把死行投影成 NULL,唯一索引就只约束存活行。

REPO gengyue-ai/soft-delete-aware-unique-constraintLICENSE MIT我们验了什么 已复现 · 2026-11-18
它解决什么

用户删掉一条记录,却再也不能创建同名的:那条软删行还占着唯一索引。

软删和唯一索引天生是一对敌人:被删的行仍然是行,所以它仍然占着那个键。「NULL 不等于 NULL,所以索引会忽略软删行」这句话只在被约束的列本身为 NULL 时成立——而 slug 不是。

办法就是让它变成 NULL:

ALTER TABLE projects
  ADD COLUMN slug_live VARCHAR(100)
    GENERATED ALWAYS AS (IF(deleted_at IS NULL, slug, NULL)) VIRTUAL,
  ADD UNIQUE KEY uk_projects_owner_slug_live (owner_id, slug_live);

索引从此只覆盖存活行。软删行保留 slug 供审计,投影进索引的是 NULL。

跑出来是什么样

ERROR 1062 (23000): Duplicate entry '1-demo' for key 'projects.uk_projects_account_slug_live'
| id | account_id | slug | live | slug_live |
|  1 |          1 | demo |    0 | NULL      |
|  3 |          1 | demo |    1 | demo      |
ERROR 1062 (23000): Duplicate entry '1-demo' for key 'projects_naive.uk_naive'

第二条存活行被拦下;软删行不挡重建;而同样的事情放在朴素的 UNIQUE (owner_id, slug) 上就失败——最后那条报错,正是用户来投诉的那个。

动 DDL 之前

  • 有没有地方在这张表上 SELECT *?虚拟列会让 * 多一列,位置式 Scan 会错位。
  • 有没有按 INFORMATION_SCHEMA 动态拼 INSERT?生成列不可写(3105)。
  • 现在还有存活重复吗?有的话索引建不起来。
  • mysqldump 这张表。这是 DDL。

我们验了什么

examples/repro.sql 在 MySQL 8.4.13(Ubuntu 26.04 / WSL)上跑过;两条 1062 报错、NULL 投影结果与「朴素约束」的对照均原样粘贴。

安装

把 SKILL.md 拷进 skills/<分类>/soft-delete-aware-unique-constraint/,或在测试库直接跑 examples/repro.sql。

仓库 ↗

出处