Golang怎么实现唯一索引防重复_Golang如何用数据库唯一约束保证数据不重复【技巧】-Golang-PHP中文网

postgresql唯一约束+on conflict是最稳防重方案，需建unique索引并明确冲突目标如on conflict (email)，golang中应解析错误码而非字符串匹配，mysql可用insert ignore或on duplicate key update。

golang怎么实现唯一索引防重复_golang如何用数据库唯一约束保证数据不重复【技巧】

直接靠应用层判断“是否存在再插入”，在并发下必然漏掉重复。数据库唯一索引才是唯一可信的防线，但光建索引不够，还得用对写法。

PostgreSQL 支持 ON CONFLICT 语法，能在冲突时跳过、更新或返回错误，比先查后插（race condition）或捕获 unique_violation 异常更简洁可靠。

UNIQUE 索引必须存在：比如对 users.email 建唯一索引，否则 ON CONFLICT 不生效
冲突目标要明确：写成 ON CONFLICT (email) 比 ON CONFLICT DO NOTHING 更安全，避免误匹配其他唯一约束
Golang 中用 sql.Exec 或 sql.QueryRow 都可以，但注意 ON CONFLICT DO NOTHING 返回影响行数为 0，不是错误

INSERT INTO users (email, name) 
VALUES ($1, $2) 
ON CONFLICT (email) DO NOTHING

MySQL 没有 ON CONFLICT，但 INSERT IGNORE 是最接近的替代——冲突时静默跳过，不报错，影响行数为 0。它比 REPLACE INTO 安全得多。

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

INSERT IGNORE 在遇到 1062 Duplicate entry 错误时转为 warning，语句继续执行，sql.ErrNoRows 不会触发
REPLACE INTO 实质是 DELETE + INSERT，会改变自增 ID、触发 DELETE 钩子、丢失原记录时间戳，且无法区分“真插入”和“假替换”
如果需要冲突后更新字段（如更新 updated_at），用 INSERT ... ON DUPLICATE KEY UPDATE，但注意它只对第一个匹配的唯一键生效

INSERT INTO users (email, name) VALUES (?, ?) 
ON DUPLICATE KEY UPDATE updated_at = NOW()

即使用了数据库层防重，有时仍需在 Go 里识别冲突并做业务响应（比如返回 “邮箱已被注册”）。但不同驱动错误结构不同，不能只靠 err.Error() 字符串匹配。

PostgreSQL（pgx）：检查 pgconn.PgError.Code == "23505"（唯一约束违规）
MySQL（mysql 或 go-sql-driver/mysql）：类型断言为 *mysql.MySQLError，再判断 Number == 1062
不要用 strings.Contains(err.Error(), "duplicate") —— 日志级别变化、翻译、中间件包装都可能破坏匹配
封装一个 IsUniqueConstraintError(err error) bool 函数，按驱动类型分别处理，后续换库也只改这一个函数

建了唯一索引不等于万事大吉。很多重复问题其实出在索引定义本身没覆盖真实业务语义。

PostgreSQL 中多个 NULL 值不违反唯一约束（NULL != NULL），如果业务要求“空邮箱也不能重复”，得加 WHERE email IS NOT NULL 的部分索引
组合唯一索引如 (tenant_id, email)，查询条件没带 tenant_id 就走不上索引，且 tenant_id 必须放前面才高效
MySQL 默认 utf8mb4_general_ci 排序规则忽略大小写，foo@ex.com 和 FOO@ex.com 被认为重复；若需区分，建索引时指定 _bin 或 _0900_as_cs 排序规则