Dapper的Execute方法返回int类型，表示SQL命令实际影响的数据库行数；插入成功返回1，批量插入返回N，UPDATE/DELETE返回匹配行数，0表示无匹配或冲突未执行，不反映执行成功与否。
Dapper 的 Execute 方法返回的是一个 int 类型的整数，它表示该 SQL 命令**实际影响的数据库行数**，不是执行成功与否的布尔值，也不是主键 ID 或其他业务值。
返回值就是“受影响行数”
这个数字直接对应数据库执行后报告的 rows affected。例如：
- 插入一条新记录且成功 → 返回 1
- 批量插入 5 条，全部成功 → 返回 5
- UPDATE 语句匹配到 3 行，其中 2 行字段值实际发生了变化 → 多数数据库（如 SQL Server、PostgreSQL）仍返回 3（只要 WHERE 匹配就计数，不管是否真正更新了数据）
- DELETE 条件没匹配到任何行 → 返回 0
- INSERT IGNORE 或 ON CONFLICT DO NOTHING 在发生冲突时未插入 → 返回 0（Dapper 能如实反映这一行为）
不等于“执行是否成功”
Execute 不抛异常 ≠ 操作成功；返回 0 ≠ 一定出错。它只管“行数”，异常由底层 ADO.NET 抛出（比如连接失败、语法错误、违反约束等）。所以：
- 返回 0 是完全合法的业务结果（如更新一个不存在的用户）
- 返回大于 0 也不代表业务逻辑正确（比如误删了多条）
- 需要结合业务语义判断：比如“新增用户”期望返回 1，若得 0 就该提示“用户名已存在”
和 Insert/Update/Delete 场景的对应关系
不同操作下返回值的典型含义：
-
INSERT：通常为 1（单条）或 N（批量），但含唯一键冲突时可能为 0（取决于 SQL 写法，如用
INSERT IGNORE或ON CONFLICT） - UPDATE：等于 WHERE 条件命中的行数，哪怕 SET 的值和原值一样（SQL Server 默认如此；MySQL 可配置是否严格检测变更）
- DELETE：等于被删除的行数，可为 0（无匹配）到任意正整数
-
存储过程调用：默认返回的是过程内最后一条可影响行数的语句的结果；如需获取 RETURN_VALUE，必须显式用
DynamicParameters添加ParameterDirection.ReturnValue参数
常见误区提醒
几个容易混淆的点：
- ❌ 不是自增主键值 —— 想取新 ID 请用 ExecuteScalar 配合
OUTPUT INSERTED.Id或SELECT SCOPE_IDENTITY() - ❌ 不是执行耗时或状态码 —— 它纯粹是数据库返回的整数
- ❌ 不会因事务回滚而返回负数 —— 回滚后 Execute 已不返回，而是抛出异常或由上层捕获
- ✅ 支持批量操作 —— 传入 List 实体或匿名对象集合时，返回的是所有批次累计影响行数
基本上就这些。理解 “返回值 = 数据库说改了几行”，就能避开大多数误判。
