Spring Boot 2函数式端点WebFluxTest不匹配带ID的PUT/DELETE请求URL

我之前在测试Spring Boot函数式端点的过滤器时也碰到过完全一样的问题，WebFluxTest对带路径变量的请求匹配确实容易踩坑，给你几个实用的解决思路：

1. 确保过滤器路由覆盖带路径变量的端点 #

首先检查你的HandlerFilterFunction是怎么绑定到路由上的。如果过滤器只绑定到固定路径（比如/resources），而没有覆盖带{id}的子路径，那PUT/DELETE请求自然不会触发过滤器。

正确的做法是用path()方法统一配置前缀，让过滤器应用到所有子路径：

@Bean
public RouterFunction<ServerResponse> resourceRouter(ResourceHandler handler, ResourceParsingFilter filter) {
    return RouterFunctions.route()
            // 统一指定前缀，过滤器会应用到所有子路径
            .path("/resources", routerBuilder -> routerBuilder
                    .PUT("/{id}", handler::updateResource)
                    .DELETE("/{id}", handler::deleteResource)
                    .GET("/{id}", handler::getResource))
            .filter(filter) // 绑定过滤器到整个前缀路径下的所有端点
            .build();
}

2. 测试时用路径变量的正确写法 #

测试带{id}的请求时，不要直接拼接字符串（比如uri("/resources/1")），而是要用带参数的uri方法传入变量值，这样WebFluxTest才能正确匹配路由的路径变量规则：

@Test
public void testPutRequestWithFilter() {
    webTestClient.put()
            .uri("/resources/{id}", "test-id-123") // 这里用占位符+变量值的方式
            .bodyValue(new Resource("test-id-123", "updated-name"))
            .exchange()
            .expectStatus().isOk();
}

3. 确认测试上下文加载了正确的Bean #

要确保@WebFluxTest注解正确加载了你的路由配置和过滤器类。如果是单独的配置类，最好显式指定：

@WebFluxTest
@ContextConfiguration(classes = {ResourceRouterConfig.class, ResourceParsingFilter.class})
public class ResourceParsingFilterTest {

    @Autowired
    private WebTestClient webTestClient;

    // 测试方法...
}

如果你的过滤器是全局的（通过@Component注册），也要确保它被扫描到测试上下文中。

4. 调试路由匹配规则 #

如果还是不行，可以在测试里加个小技巧，打印出当前路由的匹配断言，看看带{id}的请求是否符合过滤器的匹配条件：

@Autowired
private RouterFunction<ServerResponse> resourceRouter;

@Test
public void debugRouteMatching() {
    MockServerRequest request = MockServerRequest.builder()
            .method(HttpMethod.PUT)
            .uri("/resources/123")
            .build();

    // 检查请求是否匹配路由的断言
    boolean matches = resourceRouter.route(request).isPresent();
    System.out.println("Request matches router: " + matches);
}

这能帮你快速定位是路由规则的问题，还是过滤器绑定的问题。

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