MySQL逻辑删除与唯一索引冲突解决

问题背景

在MySQL数据库设计中，逻辑删除（软删除）是一种常见的实践，它通过设置标志位（如is_delete）来标记记录被"删除"，而不是实际删除数据。然而，当表中存在唯一约束时，如在用户表中我们要求用户名必须唯一，并且用户数据不要物理删除，那这个时候可能会产生一个问题：

• 用户A（username=“Tom”)被逻辑删除（is_delete=1）
• 新用户尝试使用username="Tom"注册时
• 唯一约束阻止创建新记录，即使原始用户已被"删除"

本文将介绍解决此问题的方案。

问题复现

1.创建用户表

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是'
);

2.执行脚本：

-- 插入一条测试数据，用户名为：tom
INSERT INTO users (username, email) VALUES ('tom', 'tom@example.com');

-- 逻辑删除tom用户（is_delet设置为1）
UPDATE users SET is_delete = 1 WHERE username = 'tom';

-- 创建同名用户（is_delete不同）
INSERT INTO users (username, email) VALUES ('tom', 'new_tom@example.com');

在执行第三步时，会报错如下：

[23000][1062] Duplicate entry 'tom' for key 'users.idx_uq_username'

原因分析：从结果可以看到，在插入相同名字的记录时，违反了唯一约束idx_uq_username，但实际上用户tom已经删除了，唯一索引阻止了用户名=tom的记录插入。

解决方案

解决方案1.复合唯一索引 + 时间戳删除字段

改动点：
1）添加一个字段delete_time，用于记录被删除的时间，默认值为NULL，当删除该记录时将该字段设置为当前时间
2）新建复合唯一索引，将用户名username和删除时间delete_time字段包含在复合唯一索引中

-- 方案1
CREATE TABLE users_test1 (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是',
    delete_time DATETIME NULL DEFAULT NULL COMMENT '逻辑删除时间，默认为NULL'
);

-- 添加复合唯一索引
ALTER TABLE users_test1
ADD UNIQUE INDEX idx_unique_username_dt (username, delete_time);

-- 插入初始用户
INSERT INTO users_test1 (username, email) VALUES ('tom', 'tom@example.com');

-- 逻辑删除用户（设置删除时间）
UPDATE users_test1 SET is_delete = 1,delete_time = NOW() WHERE username = 'tom';

-- 创建同名新用户（delete_time为NULL）
INSERT INTO users_test1 (username, email) VALUES ('tom', 'new_tom@example.com');

执行完上面脚本发现并没有报错，执行查询sql

select * from users_test1;

结果如下：

+--+--------+-------------------+---------+-------------------+
|id|username|email              |is_delete|delete_time        |
+--+--------+-------------------+---------+-------------------+
|1 |tom     |tom@example.com    |1        |2025-07-13 14:55:59|
|2 |tom     |new_tom@example.com|0        |null               |
+--+--------+-------------------+---------+-------------------+

解决方案2：删除后修改唯一字段值

改动点：
在逻辑删除时，为唯一字段添加特定前缀/后缀，使其不再与原有值冲突

-- 方案2 删除后修改唯一字段值
CREATE TABLE users_test2 (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete INT(1) NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是'
);


-- 添加复合唯一索引
ALTER TABLE users_test2
ADD UNIQUE INDEX idx_unique_username (username);

-- 插入初始用户
INSERT INTO users_test2 (username, email) VALUES ('tom', 'tom@example.com');

-- 逻辑删除用户,修改用户名
UPDATE users_test2 SET is_delete = 1,username = CONCAT(username, '_deleted_', UUID_SHORT()) WHERE username = 'tom';


-- 创建同名新用户
INSERT INTO users_test2 (username, email) VALUES ('tom', 'new_tom@example.com');


select * from users_test2;

查询结果示例：

+--+------------------------------+-------------------+---------+
|id|username                      |email              |is_delete|
+--+------------------------------+-------------------+---------+
|1 |tom_deleted_100950808475992064|tom@example.com    |1        |
|2 |tom                           |new_tom@example.com|0        |
+--+------------------------------+-------------------+---------+

解决方案3. 使用历史表

修改点：将删除的记录移动到专门的历史表，主表只保留有效记录

-- 方案3
-- 主表（活跃用户）
CREATE TABLE users_test3 (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete INT(1) NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是'
);

-- 添加复合唯一索引
ALTER TABLE users_test3
ADD UNIQUE INDEX idx_unique_username (username);

-- 历史表（已删除用户）
CREATE TABLE users_test3_deleted (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete INT(1) NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是'
);

-- 添加历史表复合唯一索引
ALTER TABLE users_test3_deleted 
ADD UNIQUE INDEX idx_unique_username (username);

-- 插入测试数据
INSERT INTO users_test3 (username, email) VALUES ('tom', 'tom@example.com');

-- 逻辑删除：移动到历史表
INSERT INTO users_test3_deleted (id, username, email,is_delete)
SELECT id, username, email,1 FROM users_test3 WHERE username = 'tom';
-- 删除原纪录
DELETE FROM users_test3 WHERE username = 'tom';

-- 可以重新创建原用户名
INSERT INTO users_test3 (username, email) VALUES ('tom', 'new_tom@example.com');

select * from users_test3;
select * from users_test3_deleted;

解决方案4. 业务层校验+更新记录

修改点：
保持唯一索引不变，在业务层处理冲突

-- 创建表（普通唯一索引）
CREATE TABLE users_test4 (
    id INT AUTO_INCREMENT PRIMARY KEY ,
    username VARCHAR(50) NOT NULL COMMENT '用户名',
    email VARCHAR(100) NOT NULL COMMENT '用户邮箱',
    is_delete INT(1) NULL DEFAULT 0 COMMENT '逻辑删除标记，用于标记当前记录是否已删除，0：否，1：是'
);

-- 业务层逻辑示例伪代码：
/*
1. 先查询是否存在已删除的同名用户
   SELECT id FROM users_test4 WHERE username = ? AND is_delete = 1
2. 如果存在，则更新原记录（恢复）
   UPDATE users_test4 SET is_delete = 0, email = ? WHERE username = ?
3. 如果不存在，则新建记录
   INSERT INTO users_test4 (username, email) VALUES (?, ?)
*/

总结

• 复合唯一索引 + 时间戳删除字段：需要需修改表结构，适用于新项目设计，需保留完整数据历史且查询频繁的系统；
• 删除后修改唯一字段值：需要修改业务字段（如用户名），可能影响日志或历史记录追溯，适用于临时解决方案；
• 使用历史表：需同步维护两个表结构，备份恢复方便，查询主表的数据量比较小，查询效率高，适用于数据量大、删除频繁且需要严格区分活跃/历史数据的系统；
• 业务层校验+更新记录：不用修改字段，需编写额外校验和恢复逻辑，可能存在并发问题风险；

综合以上，建议采用方案1和方案3