Spring Boot WebFlux测试为何忽略自定义Jackson Module？

你遇到的核心问题是：当使用WebTestClient.bindToRouterFunction()创建测试客户端时，它并不会自动复用Spring上下文中已经配置好的ObjectMapper实例。这种方式属于"孤立"测试路由函数的模式，会生成一个全新的默认ObjectMapper，而这个默认实例并没有注册你的自定义Jackson模块，所以序列化时只能用默认规则处理对象。

而应用运行时，Spring会自动把你暴露的Module Bean注册到全局的ObjectMapper里，所以自定义序列化器能正常生效。

这里有几种可行的解决办法，按推荐程度排序：

1. 绑定Spring上下文创建WebTestClient（推荐） #

最简单的方式是让WebTestClient直接使用Spring应用上下文，这样它会自动复用所有已配置的Bean，包括你的自定义Jackson模块。你可以通过@AutoConfigureWebTestClient注解直接注入配置好的WebTestClient：

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureWebTestClient // 自动配置并注入WebTestClient
public class ReverserRouteTest {

    @Autowired
    private WebTestClient webTestClient; // 直接注入已配置好的客户端

    @MockBean
    public ReverserService mockReverserService;

    @Test
    public void testRouteReturnsMockedResult() {
        given(mockReverserService.reverse(anyString())).willReturn(new ReverserResult("foo", "bar"));
        
        webTestClient.get().uri("/reverse/somethingcompletelydifferent")
                .exchange()
                .expectBody().json("{\"result\":\"foo|bar\"}");
    }
}

或者如果你需要手动绑定上下文，也可以这样写：

@Autowired
private ApplicationContext context;

@Test
public void testRouteReturnsMockedResult() {
    given(mockReverserService.reverse(anyString())).willReturn(new ReverserResult("foo", "bar"));
    
    WebTestClient client = WebTestClient.bindToApplicationContext(context).build();
    client.get().uri("/reverse/somethingcompletelydifferent")
            .exchange()
            .expectBody().json("{\"result\":\"foo|bar\"}");
}

这种方式的好处是完全复用应用的配置，不需要额外手动处理序列化器。

2. 手动为WebTestClient配置自定义ObjectMapper #

如果你不想加载完整的Spring上下文，也可以手动把你的自定义模块注册到WebTestClient使用的ObjectMapper中：

@Autowired
@Qualifier("specificSerializers")
public Module jacksonModule;

@Test
public void testRouteReturnsMockedResult() {
    given(mockReverserService.reverse(anyString())).willReturn(new ReverserResult("foo", "bar"));
    
    // 创建并配置带有自定义模块的ObjectMapper
    ObjectMapper customMapper = new ObjectMapper();
    customMapper.registerModule(jacksonModule);
    
    WebTestClient client = WebTestClient.bindToRouterFunction(reverserRoutes.createRouterFunction())
            .configureClient()
            .codecs(configurer -> {
                // 替换默认的JSON编解码器为自定义的
                configurer.defaultCodecs().jackson2JsonEncoder(new Jackson2JsonEncoder(customMapper));
                configurer.defaultCodecs().jackson2JsonDecoder(new Jackson2JsonDecoder(customMapper));
            })
            .build();
            
    client.get().uri("/reverse/somethingcompletelydifferent")
            .exchange()
            .expectBody().json("{\"result\":\"foo|bar\"}");
}

这种方式适合更轻量化的测试场景，但需要手动维护编解码器的配置。

修改后运行测试，WebTestClient就会使用你的自定义序列化器，响应结果会变成{"result":"foo|bar"}，测试就能顺利通过了。

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