Spring WebFlux多路由规则下静态资源无法正常访问问题

你遇到的问题核心在于/**通配符的贪婪匹配特性，以及可能存在的路由配置顺序或细节错误。

具体原因分析 #

1. 路由组合顺序颠倒
   虽然你提到按声明顺序配置，但实际代码中可能误将通配符路由(/**)放在了静态资源路由(/static/**)前面。Spring WebFlux的函数式路由严格按照注册顺序匹配，第一个匹配的路由会处理请求，后续路由不会被触发。如果通配符路由先注册，它会捕获所有请求（包括/static开头的），直接返回index.html。

2. 静态资源路由的路径匹配模式错误
   如果你的静态资源路由仅配置了/static而非/static/**，它只能匹配/static这个精确路径，无法覆盖/static/css/main.css这类子路径，这类请求会被后续的/**路由捕获。

3. 多RouterFunction Bean的加载顺序问题
   若你将不同路由拆分为多个RouterFunction Bean，Spring会按Bean的加载顺序处理路由，而非代码编写顺序。如果通配符路由的Bean被优先加载，它会提前匹配所有请求。

正确配置示例 #

以下是符合需求的标准路由配置，确保顺序和匹配模式都正确：

@Configuration
public class AppRouter {

    @Bean
    public RouterFunction<ServerResponse> apiRoutes(UserHandler userHandler) {
        return RouterFunctions.route()
                .GET("/api/users", userHandler::getUsers)
                // 添加其他API路由
                .build();
    }

    @Bean
    public RouterFunction<ServerResponse> staticResourceRoutes() {
        return RouterFunctions.resources("/static/**", new ClassPathResource("static/"));
    }

    @Bean
    @Order(Ordered.LOWEST_PRECEDENCE) // 确保该路由最后匹配
    public RouterFunction<ServerResponse> fallbackRoutes() {
        return RouterFunctions.route()
                .GET("/**", request -> ServerResponse.ok()
                        .contentType(MediaType.TEXT_HTML)
                        .bodyValue(new ClassPathResource("static/index.html")))
                .build();
    }
}

关键注意点 #

• 用@Order(Ordered.LOWEST_PRECEDENCE)给通配符路由设置最低优先级，确保它最后被匹配。
• 静态资源路由必须使用/static/**作为匹配路径，覆盖所有/static开头的子路径。
• 若采用链式组合路由，务必保证顺序：API路由 → 静态资源路由 → 通配符路由。

你把最后一条路由改成/后能正常工作，是因为/仅匹配根路径(/)，不会捕获/static开头的请求，这类请求自然会匹配静态资源路由。

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