自定义ResponseEntity子类在WebFlux测试中反序列化失败问题排查

核心原因 #

WebTestClient与同步Spring MVC的响应处理逻辑完全不同：

• 同步Spring MVC中，消息转换器只会序列化ResponseEntity的body属性，不会处理ResponseEntity对象本身，所以自定义子类无需额外反序列化配置就能正常工作。
• WebFlux的WebTestClient在测试时，若你指定expectBody(CircuitBreakerFallbackMessage.class)，它会尝试把整个响应的完整结构（包括status、headers、body）反序列化为你的自定义子类。而你的CircuitBreakerFallbackMessage作为ResponseEntity的子类，没有提供Jackson能识别的构造方法或反序列化规则，因此抛出MismatchedInputException。

解决方案 #

方案1：放弃子类化ResponseEntity（推荐） #

定义普通的消息体类，用标准ResponseEntity包裹返回：

// 普通消息类
public class FallbackMessage {
    private String message;

    // 无参构造、getter/setter，或用Lombok的@Data注解
    public FallbackMessage(String message) {
        this.message = message;
    }

    public String getMessage() {
        return message;
    }
}

// Controller方法
@GetMapping("/fallback")
public ResponseEntity<FallbackMessage> fallback() {
    return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
            .body(new FallbackMessage("Circuit breaker triggered"));
}

// 测试代码
webTestClient.get().uri("/fallback")
        .exchange()
        .expectStatus().isServiceUnavailable()
        .expectBody(FallbackMessage.class)
        .consumeWith(result -> {
            assert result.getResponseBody() != null;
            assert result.getResponseBody().getMessage().equals("Circuit breaker triggered");
        });

方案2：给自定义子类添加反序列化支持 #

如果必须保留子类，需添加@JsonCreator构造方法，让Jackson能解析ResponseEntity的结构：

public class CircuitBreakerFallbackMessage extends ResponseEntity<String> {
    @JsonCreator
    public CircuitBreakerFallbackMessage(
            @JsonProperty("body") String body,
            @JsonProperty("statusCode") HttpStatus statusCode) {
        super(body, statusCode);
    }
}

这种方式不推荐，因为ResponseEntity并非为直接序列化设计，子类化会增加不必要的复杂度。

方案3：测试时仅反序列化body部分 #

若坚持使用自定义子类，测试时不要直接反序列化整个类，只提取body内容：

webTestClient.get().uri("/fallback")
        .exchange()
        .expectStatus().isServiceUnavailable()
        .expectBody(String.class)
        .isEqualTo("Circuit breaker triggered");

关键区别梳理 #

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