Spring Boot WebFlux从依赖包提供静态资源失败问题排查

1. 移除@EnableWebFlux（关键） #

添加@EnableWebFlux会完全禁用Spring Boot对WebFlux的自动配置，包括默认的静态资源路径映射。如果不需要完全自定义WebFlux的所有配置，直接去掉这个注解，Spring Boot会自动扫描所有依赖jar中的classpath:/static/、classpath:/public/等目录下的静态资源，这通常能解决第三方jar资源加载的问题。

如果必须保留@EnableWebFlux（比如需要自定义其他WebFlux配置），则需要手动补全所有必要的资源映射配置。

2. 修正资源处理器配置 #

你的addResourceHandlers存在路径匹配问题，调整如下：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    // 处理所有HTML文件，包括第三方jar中的static目录
    registry.addResourceHandler("/*.html")
            .addResourceLocations("classpath*:/static/") // 结尾加斜杠，确保路径正确拼接
            .setCacheControl(CacheControl.maxAge(Duration.ofHours(1)));

    // 处理/static/**路径的资源，映射到所有jar的static目录
    registry.addResourceHandler("/static/**")
            .addResourceLocations("classpath*:/static/")
            .setCacheControl(CacheControl.maxAge(Duration.ofHours(1)))
            .resourceChain(true)
            .addResolver(new EncodedResourceResolver())
            .addResolver(new PathResourceResolver());
}

• classpath*:/static/：classpath*:会扫描所有依赖jar中的对应路径，而classpath:只会扫描当前项目的资源，这是加载第三方jar资源的核心。
• 路径结尾的斜杠：确保资源解析器能正确拼接路径，避免出现找不到文件的情况。

3. 修正SPA路由配置 #

原来的RouterFunction逻辑不够明确，调整为更精准的请求匹配：

@Bean
RouterFunction<ServerResponse> spaRouter() {
    ClassPathResource indexHtml = new ClassPathResource("static/index.html");
    // 匹配所有非API、非静态资源、非error的GET请求，返回index.html支持SPA路由
    RequestPredicate spaRoute = RequestPredicates.GET("/**")
            .and(RequestPredicates.path("/api/**").negate())
            .and(RequestPredicates.path("/error").negate())
            .and(RequestPredicates.pathExtension(ext -> !List.of("js", "css", "ico", "png", "jpg", "gif").contains(ext)));

    return RouterFunctions.route(spaRoute, request -> 
            ServerResponse.ok()
                    .contentType(MediaType.TEXT_HTML)
                    .body(BodyInserters.fromResource(indexHtml)));
}

• 明确限定GET请求，避免拦截其他请求方法。
• 使用BodyInserters.fromResource正确返回静态资源，逻辑更清晰可靠。

4. 验证第三方jar的资源结构 #

确保webui模块打包后的jar中，静态资源的路径是static/index.html和static/assets/，而非嵌套在其他目录下。可以用解压工具打开webui的jar包，确认目录结构符合Spring Boot的静态资源规范。

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