You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Cloud Gateway本地响应缓存配置失败求助

问题分析与解决方案

你的问题核心是使用的Spring Cloud版本过低,LocalResponseCacheGatewayFilterFactory是Spring Cloud Gateway 3.2.0(对应Spring Cloud 2022.0.0 代号Kilburn)及以上版本才新增的功能,旧版本不存在该过滤器及对应的配置项。

步骤1:升级Spring Cloud版本

确保你的项目依赖的Spring Cloud版本符合要求,以下是pom.xml的核心配置示例:

<dependencyManagement>
    <dependencies>
        <!-- Spring Cloud 依赖管理,使用2022.0.0及以上版本 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.4</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- Spring Boot 依赖管理,对应Spring Cloud 2022.x的Boot版本是3.0.x -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>3.0.8</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- Spring Cloud Gateway 核心依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
</dependencies>

步骤2:配置本地响应缓存

版本升级完成后,即可按照官方文档配置:

1. 启用全局缓存开关

在application.yml中添加:

spring:
  cloud:
    gateway:
      filter:
        local-response-cache:
          enabled: true # 启用本地响应缓存功能

2. 为特定路径的GET请求配置缓存过滤器

在路由规则中添加LocalResponseCache过滤器,并通过断言限制仅对GET请求生效:

spring:
  cloud:
    gateway:
      routes:
        - id: cached_route
          uri: http://your-backend-service.com
          predicates:
            - Path=/api/cached/**
            - Method=GET # 仅缓存GET请求
          filters:
            - name: LocalResponseCache
              args:
                cacheTime: 30m # 缓存有效期30分钟
                maxSize: 500MB # 缓存最大容量500MB

或者使用简化写法:

filters:
  - LocalResponseCache=30m,500MB

验证配置

启动项目后,可通过查看日志确认过滤器已加载,或发送多次GET请求到目标路径,观察后端服务的请求次数是否减少,以此验证缓存生效。

内容的提问来源于stack exchange,提问作者Philicoet

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.29 09:26:04