Dapper怎么结合依赖注入使用 Dapper在ASP.NET Core中DI配置

发布日期： 2026-01-15 阅读量： 作者： 煙雲

Dapper 可无缝集成 ASP.NET Core DI 容器，需将 IDbConnection 或仓储服务注册为 Scoped 生命周期，避免 Singleton 导致连接复用；推荐封装为接口+实现类并注入 IDbConnection；事务需显式管理。

Dapper 本身是一个轻量级的 ORM 工具，不内置依赖注入（DI）能力，但它可以无缝集成到 ASP.NET Core 的 DI 容器中。关键在

于：把 IDbConnection 或封装好的仓储/服务注册为 DI 服务，并确保生命周期合理（如 Scoped），避免连接泄漏或跨请求复用。

注册 IDbConnection（推荐 Scoped）

不要直接注册 SqlConnection 实例，而应注册一个工厂委托或封装类，让每次请求都创建新连接：

在 Program.cs 中配置连接字符串并注册连接工厂：

var connectionString = builder.Configuration.GetConnectionString("Default");
builder.Services.AddScoped(sp => 
    new SqlConnection(connectionString));

⚠️ 注意：必须用 Scoped（不能是 Singleton），因为 SqlConnection 不是线程安全的，且需随请求释放。

封装 Dapper 操作为服务（推荐方式）

更清晰、可测试、易维护的做法是定义接口 + 实现类，把 Dapper 逻辑封装进去：

定义仓储接口：IUserRepository
实现类中通过构造函数注入 IDbConnection：

public class UserRepository : IUserRepository
{
    private readonly IDbConnection _connection;
    public UserRepository(IDbConnection connection) => _connection = connection;
public async Task GetById(int id) =>
    await _connection.QueryFirstOrDefaultAsync(
        "SELECT * FROM Users WHERE Id = @Id", new { Id = id });
}注册服务：services.AddScoped();

避免常见陷阱
几个高频出错点要特别注意：


别在 Singleton 服务里持有 IDbConnection：会导致连接被多个请求共用，可能抛出“连接已关闭”或并发异常

手动调用 Open() 要谨慎：Dapper 大多数方法（如 QueryAsync）会自动打开关闭连接，但如果你显式调用了 Open()，记得配对 Close() 或用 using


事务需显式管理：若要用事务，建议注入 IDbTransaction 或在服务中用 _connection.BeginTransaction()，并在仓储方法中传入

进阶：支持多数据库（如 SQL Server + PostgreSQL）
可通过泛型仓储或工厂模式解耦：

注册不同连接类型：services.AddScoped()

仓储构造函数接收工厂而非裸连接，按需创建对应连接
配合 IOptions 动态切换连接字符串

基本上就这些。Dapper 和 DI 结合不复杂，核心就三点：连接生命周期对、封装有接口、事务自己管。

上一篇: iOS17.1RC版更新详情

下一篇: 如何使用pprof分析Golang性能_Go性能分析工具使用

Dapper怎么结合依赖注入使用 Dapper在ASP.NET Core中DI配置

随便看看

南昌壹佳企网络通信有限公司