话说回来，

在实际项目中。很多开发者常常面临以下痛点：

• 业务代码与数据访问代码混杂——导致维护成本高、改动风险大。
• 单元测试难以实现——因为业务层直接依赖具体的 ORM，无法轻松 Mock。
• 切换数据库技术成本大——一旦决定从 EF Core 换到 Dapper，几乎要重写所有数据访问代码。
• 事务管理混乱——跨多个仓储的操作难以统一提交或回滚。

下面通过 .NET Core + EF Core 的完整示例。程序化地解决这些痛点，让你基本掌握仓储模式的使用技巧。

一、仓储模式概述

主要概念

• 仓储业务逻辑和数据库之间的中介，像内存中的集合一样提供增删改查。
• 作用业务层只调用仓储方法，不需要关心数据是怎么存取的。
• 优势
  1. 说到解耦，数据访问与业务逻辑分离。其实，
  2. 说到可测试。无需真实数据库即可进行单元测试。话说回来，
  3. 统一规范这方面。代码更整洁、易读，
  4. 技术可切换这方面，EF Core ↔ Dapper 等实现可以自由替换。

标准项目结构

项目
├─ Models/Entities // 实体类
├─ Data // DbContext
├─ Repositories
│ ├─ IRepository.cs // 泛型仓储接口
│ ├─ Repository.cs // 泛型仓储实现
│ ├─ IUserRepository.cs// 特定实体仓储接口
│ └─ UserRepository.cs // 特定实体仓储实现
└─ Services/Controllers // 调用仓储

二、快速实现

. 准备工作

通过 NuGet 安装必要的包：

Install-Package Microsoft.EntityFrameworkCore
Install-Package Microsoft.EntityFrameworkCore.SqlServer

. 定义实体

// Models/User.cs
public class User
{
public int Id { get;set，}
public string Name { get;set，}
public int Age { get;set，}
}

. 创建数据库上下文

// Data/AppDbContext.cs
using Microsoft.EntityFrameworkCore;public class AppDbContext : DbContext
{
public AppDbContext : base { }
public DbSet Users => Set;}

. 定义泛型仓储接口

// Repositories/IRepository.cs
using System.Linq.Expressions;public interface IRepository where T : class
{
// 查询
Task GetByIdAsync;Task GetAllAsync;Task FindAsync;// 增删改
Task AddAsync;Task UpdateAsync;Task DeleteAsync;// 保存变更
Task SaveChangesAsync;}

. 实现泛型仓储基类

// Repositories/Repository.cs
using Microsoft.EntityFrameworkCore;using System.Linq.Expressions;public class Repository : IRepository where T : class
{
protected readonly AppDbContext _dbContext;private readonly DbSet _dbSet;public Repository
{
_dbContext = dbContext;_dbSet = _dbContext.Set;}
public async Task GetByIdAsync => await _dbSet.FindAsync;public async Task GetAllAsync => await _dbSet.ToListAsync;public async Task
FindAsync =>
await _dbSet.Where.ToListAsync;public async Task AddAsync => await _dbSet.AddAsync;public Task UpdateAsync
{
_dbSet.Update;话说回来，return Task.CompletedTask;}
public Task DeleteAsync
{
_dbSet.Remove;
return Task.CompletedTask;}
public async Task SaveChangesAsync => await _dbContext.SaveChangesAsync;}

. 特定实体仓储

// Repositories/IUserRepository.cs
public interface IUserRepository : IRepository
{
// 示例：根据姓名查询使用者
Task,IUserRepository
{
public UserRepository : base { }
public async Task GetUserByNameAsync
{
return await _dbContext.Users.FirstOrDefaultAsync;}
}

. 注册依赖注入

// Program.cs
builder.Services.AddDbContext(options =>
options.UseSqlServer));// 泛型仓储注册
builder.Services.AddScoped,typeof);// 特定仓储注册
builder.Services.AddScoped;话说回来，

. 在 Controller 中使用仓储

public class UserController : ControllerBase
{
private readonly IUserRepository _userRepo;public UserController
=> _userRepo = userRepo;public async Task Get
=>
{
var user = await _userRepo.GetByIdAsync;return Ok，}
public async Task Add
=>
{
await _userRepo.AddAsync;await _userRepo.SaveChangesAsync;return CreatedAtAction。new { id = user.Id },user);}
}

三、进阶：工作单元模式

工作单元 + 仓储 是公司级开发的最佳组合。能够统一管理跨多个仓储的事务提交，解决掉 “多表操作事务不一致 " 的痛点。

. IUnitOfWork 接口定义

public interface IUnitOfWork : IDisposable
{
IUserRepository Users { get;}
/// 

/// 一次性提交所有挂起的变更。/// 
Task SaveChangesAsync;}

. UnitOfWork 实现

public class UnitOfWork : IUnitOfWork
{
private readonly AppDbContext _context;public IUserRepository Users { get;}
public UnitOfWork
{
_context = context;Users = new UserRepository;}
public async Task SaveChangesAsync
=> await _context.SaveChangesAsync;public void Dispose =>
_context.Dispose;}

. DI 注册与使用

// Program.cs 继续添加：
builder.Services.AddScoped;// Controller 中使用示例：
public class OrderController : ControllerBase
{
private readonly IUnitOfWork _uow;其实，public OrderController =>
_uow = uow;public async Task Create
{
// 假设还有其他仓储，例如 ProductRepository…按理说，await _uow.Users.AddAsync;// 其它业务操作，await _uow.SaveChangesAsync;// 所有变更一次提交，事务安全。return Ok，}
}

四、仓储模式常用方法

1. #不要滥用# : 对于简单的单表 CRUD，直接使用泛型仓储即可；只有在业务复杂或需要自定义查询时才创建专用仓库。其实，
2. #IQueryable 慎用# : 接口不要返回 IQueryable;这会把查询细节泄露到业务层。推荐返回 IEnumerable / List / DTO .
3. #搭配工作单元# : 跨多个实体的写操作必须通过 UoW 保证原子性。
4. #始终使用 DI# : 切勿在代码里手动 new 仓库，否则失去解耦与可测试性。说起来，
5. #异步优先# : 在 .NET Core 环境下全程使用
6. #单元测试策略# : 利用接口抽象。在测试项目中 Mock 或 Mock,完全摆脱真实数据库依赖。
7. #错误处理统一化# : 将异常包装为自定义领域异常，让上层服务统一捕获并转换为 API 错误码。

五、适用场景

• C端或 B 端中大型公司级程序，需要长久维护和多人协作。
. li≥对事务一致性要求高的业务，如订单支付、库存扣减等。/ul>

​ ​

​

**

---

---

*

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---

---