唯一约束是强制数据完整性的逻辑规则，会自动创建同名唯一索引；唯一索引仅为物理结构，仅附带校验功能。DBeaver中应在【约束】页添加UNIQUE KEY以确保跨库兼容性和正确性。
唯一索引和唯一约束不是一回事
很多人在 DBeaver 里点「添加唯一索引」，结果发现表里还是能插入重复值——其实是因为混淆了 UNIQUE INDEX 和 UNIQUE CONSTRAINT。前者是物理结构（B+树），只加速查询、顺便校验；后者是逻辑规则，由数据库强制执行完整性检查，且会自动创建同名唯一索引。MySQL 中二者最终效果相似，但 PostgreSQL、SQL Server 等对它们的语义区分更严格：删掉约束不等于删掉索引，反之亦然。
你在 DBeaver 的【索引】标签页里加的是纯索引；在【约束】标签页里加的是约束（类型选 UNIQUE KEY）。如果目标是防止重复数据，优先走约束路径。
在【约束】页添加唯一约束（推荐）
这是最稳妥、跨库兼容性最好的方式，尤其适合 MySQL / PostgreSQL / Oracle 用户：
- 右键表 → 【编辑表】→ 切到【约束】标签页
- 右键空白处 → 【新建约束】→ 类型选
UNIQUE KEY - 勾选要参与唯一性的字段（支持多列组合，比如
email+tenant_id） - 注意：字段本身允许为
NULL，但NULL不参与唯一性比较（MySQL 中多个NULL值不冲突） - 点击【确定】→ 【保存】→ 【执行】，DBeaver 会生成类似
ALTER TABLE users ADD CONSTRAINT uk_email UNIQUE (email)的语句
在【索引】页添加唯一索引（适用场景有限）
如果你明确只需要索引结构（比如已有约束，但想额外建一个覆盖索引），或连接的是 DB2 / SQL Server 这类对约束/索引分离更严格的数据库，才考虑这条路：
- 右键表 → 【编辑表】→ 切到【索引】标签页
- 右键 → 【新建索引】→ 勾选
Unique复选框 - 添加字段后，DBeaver 会生成
CREATE UNIQUE INDEX idx_user_email ON users(email) - ⚠️ 风险：某些数据库（如旧版 MySQL）不会自动将该索引绑定为约束，插入重复值时可能报错，但错误信息是
Duplicate entry而非约束违例，排查时容易误判 - 不建议用它替代约束，除非你清楚自己在绕过哪层语义
执行失败常见原因和绕过方法
点【执行】后提示失败，大概率不是操作错了，而是数据已不满足唯一性：
- 先运行
SELECT email, COUNT(*) FROM users GROUP BY email HAVING COUNT(*) > 1检查重复值 - 有重复？必须先清理或合并数据，否则 DBeaver 无法提交 DDL（这是数据库底层限制，不是工具问题）
- 字段含大量
NULL？MySQL 允许，但 PostgreSQL 在UNIQUE约束下只允许一个NULL（除非用UNIQUE NULLS NOT DISTINCT，但 DBeaver GUI 不支持该语法，得手写 SQL） - 表正在被其他会话写入？DBeaver 默认开启事务，执行前可临时关闭：菜单栏 →
编辑→首选项→数据库→ 取消勾选Auto-commit，再手动执行SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED
真正容易被忽略的是：约束名不能重复。如果之前建过同名约束（哪怕已删），DBeaver 可能沿用旧名导致冲突。执行前看一眼生成的 SQL，把 uk_email 这类名字改成带时间戳或业务前缀的，比如 uk_user_email_v202611。
