Spring Cloud Gateway升级后静态资源无法加载解决方案咨询

根因说明 #

该问题是Spring Webflux 5.3.11~5.3.12版本的已知变更导致：该版本调整了ResourceHandler的默认匹配优先级，原本优先级高于Spring Cloud Gateway的路由匹配规则，调整后优先级低于网关路由，导致静态资源请求被网关路由提前拦截，无法进入自定义的静态资源处理器。

可行解决方案 #

• 方案1：调整资源处理器优先级
  在原有配置基础上显式设置资源处理器的优先级为最高，确保静态资源匹配优先于网关路由执行，修改后的代码如下：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/**")
            .addResourceLocations("/home/gecloud/dist/")
            .resourceChain(true)
            // 新增优先级配置
            .order(Ordered.HIGHEST_PRECEDENCE);
}

• 方案2：网关路由排除静态资源路径
  在Spring Cloud Gateway的路由配置中，给业务路由添加静态资源路径的排除规则，避免静态资源请求被业务路由匹配，YAML配置示例如下：

spring:
  cloud:
    gateway:
      routes:
        - id: business-service-route
          uri: lb://business-service
          predicates:
            - Path=/api/**
            # 排除所有静态资源路径匹配该路由
            - Path=!/**/*.{html,css,js,png,jpg,ico},!/index.html

• 方案3：升级到官方修复后的版本
  该问题已在Spring Webflux 5.3.13版本被官方修复，直接升级Spring Boot版本到2.5.7及以上即可，无需额外修改配置也不需要降级依赖。

你当前使用的降级spring-webflux到5.3.10版本的临时方案可以正常运行，但长期迭代更推荐使用上述三种正式方案规避兼容问题。

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