Mock LINQ查询修改委托时返回Null的问题排查与解决

测试RecoveryAccount方法时，Mock仓库类的GetByFilter方法（参数类型为Func<IQueryable<T>, IQueryable<T>>），预设返回指定的UserModel对象，但实际调用后结果为Null。问题根源在于Mock框架比对的是委托的引用而非逻辑，业务代码中传入的委托和测试代码里预设的委托是不同实例，导致匹配失败，触发不了预设返回值。

核心代码示例 #

1. GetByFilter方法定义 #

public async Task<T> GetByFilter(Func<IQueryable<T>, IQueryable<T>>? queryModifier, CancellationToken cancellationToken = default)
{...}

2. 业务方法调用 #

var user = await userRepository.GetByFilter(query => query.Where(u => u.email.Equals(email.ToLowerInvariant())));

3. 测试Mock代码（原错误写法） #

var userRepositoryMock = new Mock<IRepository<UserModel>>();
Func<IQueryable<UserModel>, IQueryable<UserModel>> query = query => query.Where(u => u.email.Equals(email.ToLowerInvariant()));
userRepositoryMock.Setup(x => x.GetByFilter(query, CancellationToken.None)).ReturnsAsync(user);

解决方案 #

方法1：匹配任意委托（快速解决） #

如果不需要验证委托的具体逻辑，只需要让Mock返回预设值，直接用It.IsAny<>匹配该委托类型即可：

userRepositoryMock.Setup(x => x.GetByFilter(It.IsAny<Func<IQueryable<UserModel>, IQueryable<UserModel>>>(), It.IsAny<CancellationToken>()))
                  .ReturnsAsync(user);

方法2：验证委托逻辑（精准匹配） #

如果需要确保委托的过滤逻辑符合预期，用It.Is<>结合自定义断言来验证委托的行为：

// 准备测试用的用户数据集
var testUsers = new List<UserModel>
{
    new UserModel { email = "test@example.com" },
    new UserModel { email = "other@example.com" }
};

userRepositoryMock.Setup(x => x.GetByFilter(It.Is<Func<IQueryable<UserModel>, IQueryable<UserModel>>>(func =>
{
    // 执行委托，检查过滤结果是否符合预期
    var filteredUsers = func(testUsers.AsQueryable()).ToList();
    return filteredUsers.Count == 1 && filteredUsers[0].email.Equals(email.ToLowerInvariant());
}), It.IsAny<CancellationToken>()))
.ReturnsAsync(user);

方法3：共享委托实例（引用匹配） #

把委托逻辑提取成公共方法或变量，让业务代码和测试代码使用同一个委托实例，这样Mock就能通过引用匹配成功：

// 定义公共的查询委托方法
public static Func<IQueryable<UserModel>, IQueryable<UserModel>> GetUserByEmail(string email)
{
    return query => query.Where(u => u.email.Equals(email.ToLowerInvariant()));
}

// 业务方法中调用
var user = await userRepository.GetByFilter(GetUserByEmail(email));

// 测试代码中复用同一个委托
userRepositoryMock.Setup(x => x.GetByFilter(GetUserByEmail(email), It.IsAny<CancellationToken>()))
                  .ReturnsAsync(user);

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