如何在GCP托管Redis集群中使用Spring Data Redis监听键空间事件

云原生阿岚

2026-8-27

问题场景

基于Spring Data Redis提供的@Indexed注解实现Redis二级索引能力，为存储的业务条目配置了TTL过期时间
该方案默认特性：主数据条目过期后，关联的二级索引不会被自动删除，Spring Data Redis可通过监听Redis键空间过期事件，在主条目TTL到期后自动清理残留的索引数据
开启键空间监听时使用配置：@EnableRedisRepositories(enableKeyspaceEvents = EnableKeyspaceEvents.ON_STARTUP)，服务启动阶段抛出错误：

ERR unknown command 'CONFIG'

问题运行环境为GCP托管Redis集群

根因分析

Spring Data Redis配置enableKeyspaceEvents = EnableKeyspaceEvents.ON_STARTUP时，启动流程会自动执行CONFIG SET notify-keyspace-events Ex命令，尝试为Redis实例开启键过期事件通知能力。GCP托管Redis服务（Memorystore）出于平台安全管控规则，禁止客户端直接执行CONFIG命令，因此抛出命令不存在的错误。

解决步骤

平台侧手动开启键空间事件配置
登录GCP Memorystore控制台，找到目标Redis实例，在配置修改页面找到notify-keyspace-events参数，将其值设置为Ex后保存，配置会动态生效，无需重启Redis实例。
调整Spring注解配置，跳过启动阶段CONFIG命令执行
修改@EnableRedisRepositories注解配置，新增keyspaceNotificationsConfigParameter = ""属性，告知Spring无需在启动时执行CONFIG命令修改Redis配置，直接注册事件监听器即可，最终配置如下：
```
@EnableRedisRepositories(
    enableKeyspaceEvents = EnableKeyspaceEvents.ON_STARTUP,
    keyspaceNotificationsConfigParameter = ""
)
```
连通性校验
若使用GCP Redis集群模式，确认业务服务所在网络与Redis实例的网络策略放通，确保服务端可以正常接收到Redis推送的键过期事件。配置完成后重启服务，写入带TTL的测试索引数据，等待TTL到期后校验二级索引是否被自动清理，确认功能生效。