Moq单元测试返回null：同内容不同字符串实例为何匹配失败？

核心原因 #

Moq默认采用引用相等匹配，而非值相等匹配。虽然两次调用ConvertToJSON生成的字符串内容完全一致，但它们是内存中两个不同的字符串实例（引用地址不同）。当你用测试里提前生成的字符串实例去MockIBlahClient.SendQuery的参数时，SUT实际调用时传入的是另一个新实例，Moq会判定参数不匹配，不会执行你预设的返回逻辑，最终返回默认值null。

解决办法 #

针对这个问题，有几种直接的修复方式：

1. 改用值匹配的参数约束
   不要直接传入字符串实例，用Moq的It.Is<T>来匹配值相等的字符串，示例代码：

   var expectedJson = VehicleProcessor.ConvertToJSON(testVehicle);
   // 用值相等替代引用相等匹配
   mockBlahClient.Setup(x => x.SendQuery(It.Is<string>(s => s == expectedJson)))
                 .Returns(yourExpectedResult);
   

2. 处理JSON序列化的格式差异（可选）
   如果序列化过程中可能出现格式细节差异（比如空格、属性顺序不同），可以用JSON深层比对来确保匹配：

   using System.Text.Json.Nodes;
   // 先把预期JSON解析为JSON节点
   var expectedJsonNode = JsonNode.Parse(VehicleProcessor.ConvertToJSON(testVehicle));
   mockBlahClient.Setup(x => x.SendQuery(It.Is<string>(s => 
       JsonNode.DeepEquals(JsonNode.Parse(s), expectedJsonNode)
   ))).Returns(yourExpectedResult);
   

3. 抽象序列化逻辑（更优雅的方案）
   把静态的ConvertToJSON方法抽象成一个可注入的服务（比如IVehicleSerializer），测试时直接Mock这个序列化服务，让它返回固定的字符串，从根源避免两次调用生成不同实例的问题：

   // 抽象接口
   public interface IVehicleSerializer
   {
       string ConvertToJSON(Vehicle vehicle);
   }
   
   // 修改VehicleProcessor依赖注入该接口
   public class VehicleProcessor
   {
       private readonly IVehicleSerializer _serializer;
       private readonly IBlahClient _blahClient;
   
       public VehicleProcessor(IVehicleSerializer serializer, IBlahClient blahClient)
       {
           _serializer = serializer;
           _blahClient = blahClient;
       }
   
       public string SendVehicleInfoToDMV(Vehicle vehicle)
       {
           var json = _serializer.ConvertToJSON(vehicle);
           return _blahClient.SendQuery(json);
       }
   }
   
   // 测试时Mock序列化服务
   var mockSerializer = new Mock<IVehicleSerializer>();
   var fixedJson = "{...}";
   mockSerializer.Setup(x => x.ConvertToJSON(It.IsAny<Vehicle>())).Returns(fixedJson);
   
   var mockBlahClient = new Mock<IBlahClient>();
   mockBlahClient.Setup(x => x.SendQuery(fixedJson)).Returns(yourExpectedResult);
   
   var sut = new VehicleProcessor(mockSerializer.Object, mockBlahClient.Object);
   

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