Java项目连不上Cassandra主因是DataStax驱动4.x与旧版Cassandra（如2.2/3.0）协议不兼容，需匹配驱动版本、正确配置SSL、超时及数据类型处理。
Java项目里连不上Cassandra，大概率是DataStax Java Driver版本和Cassandra服务端不匹配
新版DataStax Java Driver 4.x默认只支持Cassandra 3.11+ 和 4.x，如果你用的是2.2或3.0，连都连不上——不是代码写错，是协议根本不通。驱动4.x彻底弃用了Cluster.builder()这种旧API，还强制要求使用Session异步初始化，同步阻塞调用会卡死。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 查清你集群的
cassandra.yaml里cluster_name和native_transport_port（默认9042），别直接抄文档默认值 - 如果Cassandra是3.0.x，老老实实用
datastax-java-driver 3.11.4（对应Cassandra 3.11分支的最后兼容版） -
DriverConfigLoader.fromClasspath("application.conf")比硬编码更可控，但application.conf路径必须在src/main/resources下且不能拼错名
配置SSL/TLS时ssl_context报NullPointerException
不是证书路径错了，而是DriverConfigLoader没加载到ssl_engine_factory配置项。4.x驱动把SSL拆成两层：底层JVM信任库（truststore）和上层驱动级加密引擎（SslEngineFactory），漏掉任意一层都会在session.execute()时才抛空指针，而不是初始化阶段。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确保
application.conf里有完整块：datastax-java-driver { advanced.ssl-engine-factory.class = DefaultSslEngineFactory advanced.ssl-engine-factory.truststore-path = "/path/to/truststore.jks" advanced.ssl-engine-factory.truststore-password = "password" } - 路径必须是绝对路径或
classpath:前缀，相对路径如"certs/trust.jks"会被忽略 - 用
keytool -list -v -keystore truststore.jks确认别名存在，驱动不校验密码是否正确，只校验文件可读性和格式
执行session.execute()超时却收不到TimeoutException
默认情况下，驱动的request.timeout是30秒，但它只控制“从发送请求到收到第一个字节”的耗时；如果Cassandra节点卡在序列化、GC或磁盘IO，响应迟迟不来，驱动会等满整个socket.read-timeout（默认也是30秒），最终抛的是com.datastax.oss.driver.api.core.DriverTimeoutException，不是JDK原生TimeoutException。
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在
application.conf里显式设短一点：datastax-java-driver { advanced.request.timeout = 5 seconds advanced.connection.connect-timeout = 3 seconds advanced.socket.read-timeout = 8 seconds } - 捕获异常时别只写
catch (TimeoutException e)，要加catch (DriverTimeoutException e) - 批量写入时，
BatchStatement的超时由其中最慢的单条语句决定，不是整体计时
用PreparedStatement绑定参数后查不到数据，但拼SQL字符串却能查到
常见于timestamp、date、inet这类类型——驱动对setTimestamp()默认按UTC处理，而Cassandra服务端时区可能是Asia/Shanghai；或者inet字段用setString("192.168.1.1")失败，必须用setInet("192.168.1.1")。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 时间字段统一用
Instant传参：statement.bind(Instant.now())，别用Date或LocalDateTime - 查
inet字段时，用InetAddress.getByName("192.168.1.1")再绑定，或直接用setInet() - 不确定类型时，先用
session.prepare("SELECT * FROM t WHERE k = ?").toString()看驱动推断的类型，再选对应setXxx()方法
驱动4.x的配置粒度很细，但错误提示往往藏在嵌套异常里；打印e.getCause().getCause()比只看顶层异常有用得多。别迷信文档里的“推荐配置”，先跑通session.execute("SELECT now() FROM system.local")再说别的。
