xUnit测试中已Mock的IApplicantService.AddAsync返回null如何解决？

1. 修正异步测试方法返回值 #

xUnit 异步测试方法不支持 async void 类型返回值，该写法会导致测试上下文异常，出现Mock配置不生效、异常捕获错乱等问题。
把测试方法的签名修改为：

[Fact]
public async Task CreateAsync_WhenApplicantNotExist_ShouldReturn_CreatedAtActionResult_With_Resource()

2. 优化Moq异步方法配置 #

你当前用Returns(Task.FromResult())的写法虽然理论上可用，但更推荐用Moq内置的ReturnsAsync语法配置异步方法返回值，避免手动构造Task的潜在问题：

_mockApplicantService.Setup(e => e.AddAsync(It.IsAny<Applicant>()))
                    .ReturnsAsync(new Applicant { Id = 1, PersonId = 1, VacancyId = 1});

3. 验证Mock方法是否被正确调用 #

在测试用例末尾增加Mock调用验证，确认AddAsync方法确实被控制器触发：

// 确认AddAsync被调用1次
_mockApplicantService.Verify(e => e.AddAsync(It.IsAny<Applicant>()), Times.Once);

如果验证不通过，说明控制器在调用AddAsync前已经走了其他分支：

• 检查Mapper映射后的applicant对象是否为null
• 确认是否提前抛出了ResourceExistException异常进入了冲突分支

4. 调整断言顺序避免额外空引用 #

你当前的断言顺序存在逻辑问题：在访问createdAtActionResult.Value、model.PersonId后才校验对象是否为null，会导致空引用异常提前抛出，调整为以下顺序：

var createdAtActionResult = result as CreatedAtActionResult;
Assert.NotNull(createdAtActionResult);

var model = createdAtActionResult.Value as ApplicantResponseDto;
Assert.NotNull(model);

Assert.Equal(1, model.PersonId);

5. 其他边缘情况排查 #

• 如果你的IApplicantService的AddAsync有接口默认实现，确认Mock初始化时没有开启CallBase = true，该配置会让Mock优先走默认实现忽略Setup配置
• 如果你后续把It.IsAny<Applicant>()替换为具体实例匹配，确认Applicant类没有重写Equals方法导致参数匹配失败，可改用属性匹配写法：It.Is<Applicant>(a => a.PersonId == 1 && a.VacancyId == 1)

内容的提问来源于stack exchange，提问作者Ma'ruf