Spring Cloud Contract用JUnit5时生产者端返回500错误的解决办法

你遇到的问题是切换到JUnit5后，Spring Cloud Contract生成的测试类运行时返回500状态码（期望是200），但JUnit4下一切正常。这本质是Mockito参数匹配失效导致的，下面来分析原因并给出解决方法：

问题根源 #

在你的BaseTestClass的setup方法中，你用了一个具体的Request实例来stubemployeeService.getEmployee方法：

Request request = new Request();
request.setId(25);
Mockito.when(employeeService.getEmployee(request)).thenReturn(Optional.of(employee2));

但测试运行时，Controller接收的是从请求JSON反序列化出来的全新Request对象。由于你的Request类只添加了@Setter和@Getter，没有重写equals和hashCode方法，Mockito会用对象的引用相等来判断参数是否匹配——这两个对象是不同实例，所以匹配失败，employeeService.getEmployee返回空Optional，最终Controller返回500状态码。

至于JUnit4下正常，大概率是你之前的JUnit4测试配置中，stubbing逻辑用了参数匹配器，或者存在巧合的实例复用，但本质上这个参数匹配问题是一直存在的。

解决方案 #

你可以通过以下两种方式解决这个问题：

方案1：给Request类添加equals和hashCode方法 #

使用Lombok的@EqualsAndHashCode注解，让Request类根据id字段判断相等性：

@Setter @Getter @EqualsAndHashCode
public class Request {
    private Integer id;
}

这样，只要两个Request对象的id相同，Mockito就会认为它们相等，stubbing逻辑就会生效。

方案2：使用Mockito参数匹配器 #

修改setup方法中的stubbing逻辑，用参数匹配器替代具体实例，这样不管传入的Request是哪个实例，只要符合条件就会返回预设数据：

// 匹配任意Request对象
Mockito.when(employeeService.getEmployee(Mockito.any(Request.class)))
       .thenReturn(Optional.of(employee2));

// 或者更精确匹配id为25的Request
Mockito.when(employeeService.getEmployee(Mockito.argThat(req -> 
    req.getId() != null && req.getId().equals(25)
))).thenReturn(Optional.of(employee2));

额外注意点 #

你在setup中预设的Employee数据是Adam Brown，但契约中期望返回的是sara ahmadi，这会导致后续的字段断言失败。解决完状态码问题后，记得把预设的Employee数据修正为和契约一致：

Employee employee2=new Employee(25,"sara","ahmadi",25000.0,"F");

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