spring boot 集成 cassandra 时，即使配置了 `schemaaction.create_if_not_exists` 和键空间创建逻辑，表仍不自动生成，通常源于网络连通性、驱动初始化失败或配置时机问题，需结合日志、连接验证与配置校准进行系统性排查。
在 Spring Boot 应用中使用 spring-boot-starter-data-cassandra 实现 Cassandra 表的自动创建（auto DDL），依赖于 Spring Data Cassandra 的启动时 Schema 初始化机制。但该机制并非“零配置即生效”——它高度依赖底层 CQL 连接的可用性、驱动初始化成功以及配置类的正确加载顺序。以下为完整排查与修复指南：
✅ 1. 确保 SchemaAction 生效的前提条件已满足
getSchemaAction() 返回 SchemaAction.CREATE_IF_NOT_EXISTS 仅在 Cassandra Session 成功建立且元数据可访问 时才触发表结构生成。若连接失败，该动作将被静默跳过。因此，首要检查点是连接健康性：
- 启动应用时，务必查看日志中是否包含类似以下关键信息：
INFO o.s.d.c.CassandraSessionFactoryBean - Initializing Cassandra Session INFO o.s.d.c.c.CassandraAdmin - Initializing keyspace 'my_keyspace'... INFO o.s.d.c.c.CassandraAdmin - Creating table 'account'...
若缺失这些日志，尤其是 CassandraAdmin 相关输出，说明 Schema 初始化流程根本未执行。
✅ 2. 验证网络与认证连通性（最常见原因）
如答案所提示，90% 的“表未创建”问题源于网络不通或认证失败。请按顺序验证：
-
✅ 使用 cqlsh 手动测试连接（从宿主机或应用容器内执行）：
cqlsh -u
-p 若连接拒绝、超时或认证失败，则 Spring Boot 必然无法建表。
✅ 检查 Docker 网络配置：确保 Spring Boot 容器与 Cassandra 容器处于同一 Docker 网络，且 contactPoints 值使用容器名（如 cassandra）而非 localhost（Docker 内 localhost 指向容器自身）。
✅ 确认 Cassandra 已启用密码认证（authenticator: AllowAllAuthenticator → 不支持用户名/密码；应设为 PasswordAuthenticator）并重启服务。
✅ 3. 修正实体类：@PrimaryKey 使用规范
当前 Account 实体存在潜在风险：
@Table
public class Account {
@PrimaryKey private String id = UUID.randomUUID().toString(); // ❌ 危险！构造时生成，每次 new 都不同
// ...
}⚠️ 问题：字段级默认值（UUID.randomUUID().toString()）会在类加载或反序列化时意外触发，导致主键不可控；且 @PrimaryKey 应配合 @PartitionKey 显式声明分区键（尤其当主键为复合键时）。推荐写法：
@Table
@Getter @Setter @Builder @NoArgsConstructor @AllArgsConstructor
public class Account {
@PartitionKey
private String id; // ✅ 移除默认值，由业务逻辑或 `@PrePersist` 设置
private String username;
private String email;
private String name;
private String password;
}? 提示：若需自动赋 UUID，建议在 Service 层或使用 @PrePersist（需启用 JPA 兼容模式，Cassandra 原生不支持，推荐手动设置）。
✅ 4. 强化配置健壮性（可选但推荐）
在 CassandraConfiguration 中添加显式 Session 初始化检查：
@Bean
public Session session(CqlSession cqlSession) {
// 强制触发会话初始化，暴露连接异常
try {
cqlSession.execute("SELECT now() FROM system.local");
System.out.println("✅ Cassandra connection OK, proceeding with schema init...");
} catch (Exception e) {
throw new IllegalStateException("Failed to connect to Cassandra: " + e.getMessage(), e);
}
return new DefaultSession(cqlSession);
}✅ 5. 日志级别调优（快速定位）
在 application.yml 中启用 DEBUG 日志，聚焦 Cassandra 相关组件：
logging:
level:
org.springframework.data.cassandra: DEBUG
com.datastax.oss.driver: DEBUG重点关注 CassandraAdmin, CqlSession, SchemaAction 相关日志流。
? 总结
Cassandra 表未自动创建，本质是 Schema 初始化流程中断，而非配置语法错误。请严格按以下顺序排查：
1️⃣ 查日志 — 是否有 CassandraAdmin 初始化记录；
2️⃣ 测连接 — cqlsh 验证网络、端口、认证；
3️⃣ 核配置 — contactPoints 是否为容器可解析地址，SchemaAction 是否被正确继承；
4️⃣ 检实体 — 主键注解是否规范，避免运行时异常干扰初始化。
只有当 CQL Session 稳定建立后，CREATE_IF_NOT_EXISTS 才会真正执行 —— 这是理解整个机制的核心前提。
