Spring MVC Test：如何为andExpect添加自定义失败描述信息

当然可以实现！就像你说的assertTrue带消息参数那样，在Spring MVC的MockMvc测试里，我们完全可以给断言添加易读的自定义失败消息，替代默认的生硬提示。下面分享几种实用的方法：

方法一：用describedAs包装Matcher #

这是最简洁的方式，Spring集成的Hamcrest Matcher提供了describedAs方法，能直接给断言添加自定义描述。修改你的测试代码如下：

@Test public void aSampleTest() {
    this.mockMvc
        .perform(get("/ultimateQuestion"))
        .andExpect(jsonPath("$.meaningOfLife", 
            describedAs("人生的意义应该是42，实际返回了{0}", is("42"), "$.meaningOfLife")));
}

当测试失败（比如实际值是24），你会得到这样的提示：Expected: 人生的意义应该是42，实际返回了24 but was "24"，其中{0}会自动替换成实际匹配到的值，非常直观。

方法二：手动提取响应做断言 #

如果需要更灵活的消息拼接，你可以先获取响应结果，再手动做断言：

@Test public void aSampleTest() {
    MvcResult result = this.mockMvc
        .perform(get("/ultimateQuestion"))
        .andReturn();
    
    String responseBody = result.getResponse().getContentAsString();
    String actualValue = JsonPath.read(responseBody, "$.meaningOfLife");
    
    assertTrue("接口/ultimateQuestion返回的人生意义错误：预期42，实际是" + actualValue, 
        "42".equals(actualValue));
}

这种方式适合需要加入更多上下文信息的场景，比如接口路径、请求参数等，让失败消息更具针对性。

方法三：自定义ResultMatcher #

如果你经常需要用到自定义消息，可以封装一个自己的ResultMatcher，把断言逻辑和消息提示整合起来：

// 自定义工具方法
private ResultMatcher jsonPathWithCustomMessage(String expression, Matcher<?> matcher, String errorMsg) {
    return result -> {
        try {
            jsonPath(expression, matcher).match(result);
        } catch (AssertionError e) {
            // 替换成自定义消息，同时保留原始异常栈
            throw new AssertionError(errorMsg, e);
        }
    };
}

// 测试中使用
@Test public void aSampleTest() {
    this.mockMvc
        .perform(get("/ultimateQuestion"))
        .andExpect(jsonPathWithCustomMessage("$.meaningOfLife", is("42"), 
            "获取人生意义接口失败：预期返回42，实际值不匹配"));
}

这样每次测试时直接调用这个自定义方法即可，失败时会抛出你设置的清晰提示，还能保留原始的错误信息，方便定位问题。

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