寻求基于NUnit的.NET Core Web API 5.0分层架构单元测试学习资源

基础前置准备 #

• 先掌握NUnit基础语法：[TestFixture]、[Test]、[TestCase]、Assert类常用方法，以及Moq等模拟框架的基础用法，所有分层测试都需要用到依赖模拟能力。
• 所有分层测试的核心原则为：仅验证当前层的职责范围，下层依赖全部通过模拟对象替代，避免跨层耦合导致测试失效。

各分层场景测试实现方案 #

1. 控制器层测试 #

• 测试点：入参校验、返回值状态码、路由映射、服务层调用逻辑是否符合预期
• 实现要点：
  • 用Moq模拟控制器依赖的服务层接口，无需注入真实服务实现
  • 若涉及ControllerBase自带的HttpContext、User等属性，可通过ControllerContext手动赋值模拟
  • 参考代码片段：

[TestFixture]
public class TodoControllerTests
{
    private Mock<ITodoService> _mockTodoService;
    private TodoController _controller;

    [SetUp]
    public void SetUp()
    {
        _mockTodoService = new Mock<ITodoService>();
        _controller = new TodoController(_mockTodoService.Object);
    }

    [Test]
    public async Task GetById_WhenIdExists_ReturnsOkResult()
    {
        // Arrange
        var testId = 1;
        var mockTodo = new Todo { Id = testId, Content = "Test content" };
        _mockTodoService.Setup(s => s.GetByIdAsync(testId)).ReturnsAsync(mockTodo);

        // Act
        var result = await _controller.GetById(testId);

        // Assert
        Assert.That(result.Result, Is.TypeOf<OkObjectResult>());
        _mockTodoService.Verify(s => s.GetByIdAsync(testId), Times.Once);
    }
}

2. 服务层测试 #

• 测试点：业务逻辑正确性、事务处理逻辑、数据访问层调用频次/参数是否正确
• 实现要点：
  • 模拟数据访问层（Repository/DAO）接口，无需建立真实数据库连接
  • 需覆盖全业务分支：正常流程、异常抛出、参数校验失败等场景

3. 数据访问层测试（EF Core/Dapper场景） #

• 测试点：SQL生成正确性、ORM映射匹配、数据增删改查逻辑符合预期
• 实现要点：
  • 针对EF Core：使用Microsoft.EntityFrameworkCore.InMemory内存数据库或者SQLite内存模式搭建测试数据库，避免污染生产环境数据
  • 针对Dapper：可使用TestContainers搭建临时真实数据库实例，或适配内存数据库验证SQL执行逻辑
  • 每次测试执行前后重置数据库状态，保证测试用例之间互不影响
• EF Core测试参考代码片段：

[TestFixture]
public class TodoRepositoryTests
{
    private DbContextOptions<AppDbContext> _dbOptions;

    [SetUp]
    public void SetUp()
    {
        _dbOptions = new DbContextOptionsBuilder<AppDbContext>()
            .UseInMemoryDatabase(databaseName: "TestTodoDb")
            .Options;
    }

    [Test]
    public async Task AddAsync_ValidEntity_SavesToDatabase()
    {
        // Arrange
        await using var context = new AppDbContext(_dbOptions);
        var repository = new TodoRepository(context);
        var testTodo = new Todo { Id = 2, Content = "DAL Test content" };

        // Act
        await repository.AddAsync(testTodo);
        await context.SaveChangesAsync();

        // Assert
        var savedTodo = await context.Todos.FindAsync(2);
        Assert.That(savedTodo, Is.Not.Null);
        Assert.That(savedTodo.Content, Is.EqualTo("DAL Test content"));
    }

    [TearDown]
    public void TearDown()
    {
        using var context = new AppDbContext(_dbOptions);
        context.Database.EnsureDeleted();
    }
}

4. 中间件测试 #

• 测试点：请求处理逻辑、响应修改逻辑、异常处理、请求管道跳转逻辑
• 实现要点：
  • 使用TestServer搭建模拟请求管道，无需启动真实Web服务
  • 构造模拟HttpContext对象传入中间件，验证中间件处理后的上下文属性是否符合预期
  • 常见测试场景：测试异常处理中间件时，模拟后续管道抛出异常，验证中间件是否返回正确的错误响应格式

通用测试规范 #

• 每个测试用例遵循Arrange（准备测试数据/模拟对象）、Act（执行测试逻辑）、Assert（验证结果）三段式结构，提升可读性
• 测试命名统一采用被测方法_触发场景_预期结果的格式，方便问题排查
• 避免在单元测试中引入硬编码配置、外部服务依赖，保证测试可以离线独立运行

内容的提问来源于stack exchange，提问作者Dibyo Chatterjee