Datastax Cassandra driver 4.x mapper处理UDT时字段识别错误问题求助

核心原因 #

Datastax Java Driver 4.x 对表实体和UDT（用户自定义类型）的注解规则做了严格区分，@Entity注解仅用于标记映射到Cassandra表的实体类，你为UDT类Campaign错误添加了@Entity注解，导致注解处理器将其识别为表实体，在校验Profile表字段时误将Campaign的字段当作表字段校验，触发缺失字段报错。

修复步骤 #

1. 修改Campaign类注解：删除@Entity注解，替换为4.x驱动专用于UDT的@UDT注解，示例如下：

// 导入路径：com.datastax.oss.driver.api.mapper.annotations.UDT
@UDT(name = "campaign")
public class Campaign {
    ...
    @CqlName("partner_id")
    private int partnerId;

    @CqlName("campaign_id")
    private int campaignId;
    ...
}

如果你的UDT和业务表不在同一个keyspace，需要额外指定keyspace参数：@UDT(keyspace = "proj", name = "campaign")。
2. 注册UDT到Mapper上下文：构建Mapper实例时显式注册UDT类，避免运行时识别失败：

MainDaoMapper mapper = new MainDaoMapperBuilder(session)
    .withUdtClasses(Campaign.class)
    .build();

3. 清理无效配置：删除所有针对Campaign类的表实体DAO、Accessor接口定义，UDT不需要单独配置表访问逻辑。
4. 清空编译缓存后重新编译项目，触发注解处理器重新生成Mapper代码，之前生成的错误校验逻辑会被自动替换。

额外说明 #

Driver 4.x的Mapper组件会自动处理UDT的序列化和反序列化，不需要额外自定义Codec，只要注解配置正确即可正常识别嵌套UDT字段。

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