Dapper怎么防止重复插入数据 Dapper唯一性约束处理

用 Dapper 防止重复插入，核心不是靠 Dapper 本身（它只是轻量 ORM，不提供自动去重或约束拦截），而是靠数据库层面的唯一性约束 + 合理的异常捕获与业务处理。Dapper 的角色是帮你把错误暴露出来，并让你能优雅应对。

数据库建唯一索引是前提

没有数据库级的 UNIQUE 约束或唯一索引，任何代码层的判断都可能因并发而失效。比如对用户名、邮箱、订单号等字段，必须在数据库中显式添加：

CREATE UNIQUE INDEX IX_Users_Email ON Users(Email);

CREATE UNIQUE INDEX idx_users_email ON users(email);

ALTER TABLE users ADD UNIQUE(email);

这是防重最可靠、最高效的一道防线。

用 try-catch 捕获唯一性冲突异常

Dapper 执行

Execute()

SqlException.Number == 2627 或 2601

SqlException.SqlState == "23505"

示例（SQL Server）：

try
{
    conn.Execute("INSERT INTO Users (Email, Name) VALUES (@email, @name)", user);
}
catch (SqlException ex) when (ex.Number == 2627 || ex.Number == 2601)
{
    throw new InvalidOperationException("邮箱已存在，请更换");
}

插入前 SELECT 检查（慎用，仅限低并发或强业务校验场景）

虽然不如唯一索引可靠（存在检查后、插入前的竞态窗口），但在某些需要提前反馈、或需组合条件判断的场景（如“同一手机号+同一渠道当天只能注册一次”），可先查再插：

QuerySingleOrDefault<int>()</int>

QueryFirstOrDefault<bool>()</bool>

BeginTransaction

更推荐把它当作“用户体验优化”——提前提示，而不是“数据安全依赖”。

用 MERGE / UPSERT 替代单纯 INSERT（推荐进阶方案）

多数现代数据库支持原子化的“存在则忽略/更新”语句，Dapper 可直接执行：

MERGE INTO ... WHEN NOT MATCHED THEN INSERT

INSERT ... ON CONFLICT DO NOTHING

INSERT OR IGNORE

这类语句由数据库保证原子性，既避免异常，又省去 try-catch。Dapper 调用方式不变，只是 SQL 更健壮：

conn.Execute(@"
    INSERT INTO users (email, name) 
    VALUES (@email, @name) 
    ON CONFLICT (email) DO NOTHING", user);

执行后可通过

Execute()

基本上就这些。Dapper 不负责防重，但它足够灵活，让你能干净地配合数据库能力实现可靠防重——关键在设计时就想好约束在哪一层生效，别把鸡蛋全放在代码里。