FakeItEasy 8中集合参数匹配行为的重大变更及解决方案

背景介绍

在单元测试中，我们经常使用Mock框架来模拟依赖对象的行为。FakeItEasy作为.NET平台上一个流行的Mock框架，在版本8中对集合参数的匹配逻辑进行了重大调整。这一变化虽然提高了大多数场景下的便利性，但也导致了一些现有测试用例的失败。

问题现象

当被测接口继承自集合接口（如IReadOnlyCollection<T>）时，在FakeItEasy 8中会出现参数匹配行为与版本7不一致的情况。例如以下测试代码：

public interface IFoo : IReadOnlyCollection<object> { }

public interface IFooMatcher {
    bool Matches(IFoo foo);
}

[Test]
public void TestMethod() {
    var context1 = A.Fake<IFoo>();
    var context2 = A.Fake<IFoo>();
    
    var extractor = A.Fake<IFooMatcher>();
    A.CallTo(() => extractor.Matches(context1)).Returns(false);
    A.CallTo(() => extractor.Matches(context2)).Returns(true);
    
    Assert.That(extractor.Matches(context1), Is.False);
}

在FakeItEasy 7中能正常通过的测试，在版本8中可能会失败。这是因为版本8开始会对集合内容进行深度比较，而不是简单的引用比较。

解决方案

方案1：显式指定引用比较

最直接的解决方案是使用A<T>.That.IsSameAs()方法显式指定进行引用比较：

A.CallTo(() => extractor.Matches(A<IFoo>.That.IsSameAs(context1))).Returns(false);
A.CallTo(() => extractor.Matches(A<IFoo>.That.IsSameAs(context2))).Returns(true);

方案2：创建辅助方法简化代码

如果需要在多处使用引用比较，可以创建一个辅助方法来简化代码：

static class Helpers {
    public static T ByRef<T>(T value) where T : class {
        return A<T>.That.IsSameAs(value);
    }
}

// 使用示例
A.CallTo(() => extractor.Matches(ByRef(context1))).Returns(false);

方案3：全局配置参数比较方式

如果需要完全恢复版本7的行为，可以配置全局的自定义参数比较器：

public class ReferenceEqualityComparer : IArgumentEqualityComparer {
    public bool CanCompare(Type type) => true;
    
    public bool AreEqual(object expected, object actual) {
        return ReferenceEquals(expected, actual);
    }
}

// 在测试初始化时注册
FakeItEasy.Configuration.FakeItEasy.Configuration.UseCustomArgumentEqualityComparer(
    new ReferenceEqualityComparer());

设计建议

从设计角度考虑，如果一个类型的主要职责不是作为集合使用，建议：

1. 避免直接实现集合接口
2. 改为通过属性或方法暴露集合内容
3. 保持单一职责原则，使类型意图更清晰

总结

FakeItEasy 8对集合参数的匹配行为进行了优化，虽然带来了更智能的默认行为，但也需要注意其对现有测试的影响。通过理解这一变更的本质，我们可以灵活选择最适合项目的解决方案，既可以利用新版本的特性，又能保证现有测试的稳定性。

在实际项目中，建议根据具体情况选择解决方案。对于新项目，可以考虑遵循FakeItEasy 8的设计理念；对于已有大型项目，则可能需要权衡修改成本与收益，选择最合适的迁移策略。