如何在Spring中为Redis JPA仓库的键添加自定义静态前缀？

算力阿峰

2026-10-5

解决方案

针对Spring Data Redis JPA仓库的全局键前缀需求，有两种常用实现方案：

方案1：单实体快速配置（适用于实体数量少的场景）

直接在每个Redis实体的@RedisHash注解中拼接统一前缀即可，无需额外全局配置，示例如下：

// 原有配置
// @RedisHash("product")
// 加前缀后的配置
@RedisHash("my_app_namespace:product")
public class Product {
    @Id
    private String id;
    // 其他属性省略
}

配置后该实体对应的所有Redis键格式会自动变为my_app_namespace:product:{实体ID}。

方案2：全局统一配置（推荐，无需逐个修改实体）

通过自定义键空间解析逻辑，给所有Redis JPA实体自动加统一前缀，步骤如下：

新增Redis配置类，重写键空间生成规则：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.core.mapping.RedisMappingContext;
import org.springframework.data.redis.repository.configuration.EnableRedisRepositories;

@Configuration
@EnableRedisRepositories
public class RedisRepositoryConfig {

    // 前缀可从配置文件注入，也可直接写固定值
    @Value("${redis.repository.key-prefix:my_global_namespace:}")
    private String globalKeyPrefix;

    @Bean
    public RedisMappingContext redisMappingContext() {
        return new RedisMappingContext() {
            @Override
            public String getKeySpaceFor(Class<?> type) {
                // 拼接全局前缀到默认的键空间前
                return globalKeyPrefix + super.getKeySpaceFor(type);
            }
        };
    }
}

该配置会自动识别所有Redis JPA实体，给所有实体的键统一加上前缀，后续新增实体也无需额外配置，自动生效。