SpringDataRedis复合索引使用教程

Spring Data Redis 虽不支持 MongoDB 风格的声明式复合索引（如 @CompoundIndex），但巧妙借助多字段 @Indexed 注解与符合命名规范的方法（如 findByStatusAndRole）实现了逻辑等价的多条件联合查询——底层自动调用 Redis 的 SINTER 命令求交集，高效筛选同时满足多个条件的记录；不过该方案在大数据量下存在性能瓶颈，且不支持 OR、范围查询、排序等高级功能，若需真正强大的复合索引、全文检索或聚合能力，推荐升级至 Redis OM Spring 或直接集成 Redis Stack 的 FT.SEARCH 引擎。

Spring Data Redis 本身不支持类似 MongoDB 的复合索引注解（如 @CompoundIndex），但可通过多字段 @Indexed 配合方法名查询（如 findByField1AndField2）实现逻辑等价的多条件检索，底层利用 Redis 的 SINTER 求交集完成高效联合过滤。

Spring Data Redis 本身不支持类似 MongoDB 的复合索引注解（如 @CompoundIndex），但可通过多字段 @Indexed 配合方法名查询（如 findByField1AndField2）实现逻辑等价的多条件检索，底层利用 Redis 的 SINTER 求交集完成高效联合过滤。

在 Spring Data Redis 中，虽然没有直接提供 @CompoundIndex 这样的声明式复合索引注解（如 Spring Data MongoDB 所支持），但其索引机制天然支持多字段联合查询的语义等价实现。核心原理在于：当多个字段被标注 @Indexed 时，框架会为每个字段单独维护一个 Redis Set（即二级索引），并在执行符合命名约定的查询方法时，自动组合这些索引集合——对 AND 类型条件（如 findByStatusAndType），Spring Data Redis 会调用 SINTER 命令求多个索引 Set 的交集，从而精准定位同时满足所有条件的键。

例如，定义如下实体：

@RedisHash("user")
public class User {
    @Id
    private String id;

    @Indexed
    private String status; // e.g., "ACTIVE", "INACTIVE"

    @Indexed
    private String role;   // e.g., "ADMIN", "USER"

    private String name;
    // constructors, getters, setters...
}

在对应的 UserRepository 中声明方法即可启用多字段联合索引查询：

public interface UserRepository extends CrudRepository<User, String> {
    // ✅ 自动触发 SINTER: 查询 status="ACTIVE" AND role="ADMIN"
    List<User> findByStatusAndRole(String status, String role);

    // ✅ 支持更复杂的组合（顺序无关）
    List<User> findByRoleAndStatus(String role, String status);

    // ✅ 也支持 IN + AND 组合（需注意性能边界）
    List<User> findByStatusInAndRole(List<String> statuses, String role);
}

⚠️ 注意事项：

• SINTER 时间复杂度为 O(N×M)（N、M 为各集合元素数），当任一索引 Set 过大（如百万级）时，性能可能显著下降；建议对高基数字段（如 email）谨慎索引。
• 不支持 OR、范围查询（>, BETWEEN）、全文搜索或排序（OrderBy）等复杂操作——这些是原生 Spring Data Redis 索引模型的固有局限。
• @Indexed 仅适用于 @RedisHash 实体的字段，不适用于嵌套对象或 List/Map 内部字段。

如需真正意义上的复合索引、模糊匹配、聚合分析或高性能范围查询，推荐升级技术栈：
✅ Redis OM Spring（github.com/redis/redis-om-spring）基于 Redis Stack 的 FT.SEARCH 引擎，支持 @Document + @Searchable 注解、复合索引定义、JSON 路径查询与实时聚合，是面向现代 Redis 应用的增强型 ORM 方案。

综上，Spring Data Redis 的“伪复合索引”是轻量级场景下的实用方案；而生产级复杂查询需求，应结合 Redis OM Spring 或直接使用 Redis Search 原生命令进行精细化控制。

今天关于《SpringDataRedis复合索引使用教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！