在Achilles Cassandra中同一列同时用作聚类列与二级索引编译报错

我之前在使用Achilles 5.x版本时也碰到过一模一样的问题，本质是框架代码生成时的方法命名冲突导致的。

问题原因 #

当你给一个字段同时标记@ClusteringColumn和@Index时，Achilles会为这个字段生成两套查询相关的方法：

• 一套是针对聚类列的分区内查询方法
• 另一套是针对二级索引的跨分区查询方法

这两套方法都会以字段名（比如fname()）作为方法名，所以在生成Users_SelectIndex.java这类DSL代码时，就会出现“方法已定义”的编译错误。

解决方案 #

根据你的业务需求，推荐以下两种处理方式：

1. 去掉二级索引（优先推荐）

如果你的查询场景只是在同一个分区内（按userID分区）过滤或排序fname，那完全不需要二级索引——Cassandra的聚类列本身就支持在分区内的高效过滤和排序。直接去掉@Index注解即可解决编译问题：

@Data @Builder @NoArgsConstructor @AllArgsConstructor @Table(table="users")
public class Users{
    @PartitionKey @Column private String userID;
    @ClusteringColumn @Column private String fname; // 移除@Index注解
}

2. 重构数据模型，使用专门的索引表（适合跨分区查询场景）

如果你需要跨多个userID分区查询特定fname的用户，那更符合Cassandra设计理念的做法是创建一张专门的索引表，而不是依赖二级索引（Cassandra二级索引跨分区查询性能较差）：

// 原用户表，保持聚类列设计，不添加二级索引
@Data @Builder @NoArgsConstructor @AllArgsConstructor @Table(table="users")
public class Users{
    @PartitionKey @Column private String userID;
    @ClusteringColumn @Column private String fname;
    // 其他业务字段...
}

// 专门的索引表，用于跨分区按fname查询
@Data @Builder @NoArgsConstructor @AllArgsConstructor @Table(table="users_by_fname")
public class UsersByFname{
    @PartitionKey @Column private String fname; // 将fname作为分区键
    @ClusteringColumn @Column private String userID; // userID作为聚类列，保证唯一性
    // 可按需复制需要展示的字段，或仅存userID关联回原表查询详情
}

这种方式不仅能避免Achilles的代码生成冲突，还能获得更优的查询性能。

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