Dapper调用存储过程其实很直接，关键在于三点：指定 CommandType.StoredProcedure、传对参数类型、选对执行方法（
Query/
Execute/
QueryMultiple）。它不封装 SQL Server 的复杂性，但把底层细节控制权交给你，所以写法清晰、性能好、不易出错。
基础调用：无参或仅输入参数
最常见场景，比如查用户列表或更新单条记录。Dapper 支持用匿名对象传参，简洁高效：
连接打开后，直接调用Query<t>()</t>（查数据）或
Execute()（增删改） 必须显式指定
commandType: CommandType.StoredProcedure参数用匿名对象即可，字段名要和存储过程中定义的参数名完全一致（大小写不敏感，但建议保持一致）
示例：
using (var conn = new SqlConnection(connStr))
{
conn.Open();
var users = conn.Query<User>("sp_GetUsersByStatus",
new { Status = 1 },
commandType: CommandType.StoredProcedure).ToList();
}
带输出参数：必须用 DynamicParameters
Dapper 原生不支持从匿名对象读取
OUTPUT或
RETURN参数，这时得用 DynamicParameters 类——它是 Dapper 提供的可变参数容器。 每个
Add()调用需明确指定参数名、值、
DbType、
ParameterDirection输出参数的值在执行后通过
Get<t>()</t>方法提取 注意：
OUTPUT参数在调用前可不赋初值，但
RETURN参数需设
direction: ParameterDirection.ReturnValue
示例：
var dp = new DynamicParameters();
dp.Add("@UserId", 1001, DbType.Int32, ParameterDirection.Input);
dp.Add("@Msg", dbType: DbType.String, size: 200, direction: ParameterDirection.Output);
dp.Add("@ResultCode", dbType: DbType.Int32, direction: ParameterDirection.ReturnValue);
conn.Execute("sp_UpdateUserWithLog", dp, commandType: CommandType.StoredProcedure);
string msg = dp.Get<string>("@Msg");
int code = dp.Get<int>("@ResultCode");
返回多个结果集：用 QueryMultiple
一个存储过程里如果写了多条
SELECT（比如先查用户再查其角色），Dapper 不会自动合并，要用 QueryMultiple 分步读取。 调用后得到一个
GridReader对象 每调一次
.Read<t>()</t>就消费一个结果集，顺序必须和存储过程中
SELECT的顺序一致 支持不同泛型类型，比如
Read<user>()</user>和
Read<role>()</role>
示例：
using (var multi = conn.QueryMultiple("sp_GetUserAndRoles",
new { UserId = 123 },
commandType: CommandType.StoredProcedure))
{
var user = multi.Read<User>().FirstOrDefault();
var roles = multi.Read<Role>().ToList();
}
异步调用与事务配合
Dapper 所有核心方法都有异步版本（
QueryAsync、
ExecuteAsync、
QueryMultipleAsync），适合高并发 Web 场景。 异步调用时，输出参数仍可用
DynamicParameters，执行完再取值 若需事务控制，把连接和事务对象一起传入（
transaction参数），存储过程会在同一事务上下文中运行 注意：事务必须由你手动
BeginTransaction()，并负责
Commit()或
Rollback()
示例（事务中执行两个存储过程）：
using (var conn = new SqlConnection(connStr))
{
await conn.OpenAsync();
using var tx = await conn.BeginTransactionAsync();
try
{
await conn.ExecuteAsync("sp_CreateOrder", orderParams, tx, commandType: CommandType.StoredProcedure);
await conn.ExecuteAsync("sp_SendNotification", notifyParams, tx, commandType: CommandType.StoredProcedure);
await tx.CommitAsync();
}
catch
{
await tx.RollbackAsync();
throw;
}
}
基本上就这些。Dapper 调用存储过程不复杂但容易忽略细节——比如漏写
CommandType.StoredProcedure、混淆
Output和
ReturnValue、或多结果集读取顺序错乱。按场景选对方法，参数配准类型，基本不会踩坑。
