Moq+xUnit+ASP.NET Core测试：Mock Repository调用返回Null问题排查

你遇到的核心问题是Moq对引用类型参数的匹配规则导致Mock未触发预设逻辑，最终使得searchResults始终为null，下面具体拆解问题和修复方案：

具体问题点 #

1. 引用类型参数的匹配不生效
   在测试代码里，你手动创建了一个AdvisorSearchOptions实例来设置Mock的预期调用：

   _repositoryMock
       .Setup(x => x.SearchAdvisors(filter.CID.Value, new AdvisorSearchOptions {
           // 属性赋值逻辑
       }))
       .Returns(...);
   

   但在Service的Search方法中，是新建了一个完全独立的AdvisorSearchOptions实例（var opts = new AdvisorSearchOptions { ... }）。Moq默认会检查参数的引用是否相等，这两个实例是不同对象，所以Mock的Setup条件没有被触发，自然返回默认的null。

2. 潜在拼写错误（非直接原因，但建议修复）
   注意到你代码里的SeachKey（少了一个r，正确应为SearchKey），虽然这不是导致searchResults为null的直接原因，但长期来看可能引发其他逻辑错误，建议统一修正。

修复方案 #

你可以通过以下两种方式解决参数匹配问题：

方案1：使用It.Is<T>进行属性匹配 #

告诉Moq，只要传入的AdvisorSearchOptions对象的关键属性和预期一致，就返回预设结果，这是最推荐的无侵入式方案：

_repositoryMock
    .Setup(x => x.SearchAdvisors(
        filter.CID.Value,
        It.Is<AdvisorSearchOptions>(opts => 
            opts.SearchKey == filter.SeachKey &&
            opts.AdvisorId == filter.AdvisorId &&
            opts.BranchId == filter.BranchId &&
            opts.City == filter.City &&
            opts.Skip == filter.Skip &&
            opts.Limit == filter.Limit &&
            opts.RadiusInMiles == filter.Limit &&
            opts.Longitude == filter.Longitude &&
            opts.Latitude == filter.Latitude
        )
    ))
    .Returns(Task.FromResult<SearchResults<Advisor>>(
        new SearchResults<Advisor>() {
            Count = 1,
            Limit = 0,
            Skip = 0,
            ResultItems = new List<SearchResultItem<Advisor>>() {
                // 你的初始化逻辑
            }
        }) 
    );

方案2：复用AdvisorSearchOptions实例（侵入性较强） #

如果测试和Service的参数构造逻辑完全一致，可以在测试中提前构造实例，让Service也复用这个实例（需要修改Service代码，仅推荐用于测试专用重构）：

// 测试中提前构造实例
var expectedOpts = new AdvisorSearchOptions {
    SearchKey = filter.SeachKey,
    AdvisorId = filter.AdvisorId,
    // 其他属性赋值
};
_repositoryMock
    .Setup(x => x.SearchAdvisors(filter.CID.Value, expectedOpts))
    .Returns(...);

// 修改Service的Search方法，复用传入的参数实例（示例）
public async Task<ViewModelBase> Search(int brokerDealerId, FilterParams filter, AdvisorSearchOptions opts = null) {
    opts ??= new AdvisorSearchOptions {
        // 原构造逻辑
    };
    // 后续逻辑不变
}

额外验证建议 #

修复后，可以在测试末尾添加Mock调用验证，确认Setup确实被触发：

_repositoryMock.Verify(x => x.SearchAdvisors(
    filter.CID.Value,
    It.IsAny<AdvisorSearchOptions>()), Times.Once);

如果参数匹配仍有问题，这行代码会直接抛出异常，帮你快速定位问题。

内容的提问来源于stack exchange，提问作者jack.pop