DBeaver连接Cassandra失败主因是驱动未正确安装或配置错误；需手动添加DataStax官方驱动jar包（如java-driver-core-4.x.x.jar及依赖），类名填com.datastax.oss.driver.internal.core.Driver，URL模板为jdbc:cassandra://{host}[:{port}]/[{keyspace}]，端口设9042，且须确保Cassandra服务运行、认证权限配置到位。
直接连不上 Cassandra，大概率是驱动没装对、类名写错，或者 URL 模板里漏了关键参数。DBeaver 本身不带 Cassandra 驱动，必须手动加 jar 包并配对类名和 URL 格式，缺一不可。
选哪个驱动：DataStax Java Driver 还是 Simba JDBC？
优先用 com.datastax.oss:java-driver-core（DataStax 官方驱动），它更稳定、更新及时、兼容 Cassandra 4.x+；Simba 驱动（com.simba.cassandra.jdbc42.Driver）多见于旧项目或 BI 场景，但对 Cassandra 4.1+ 支持弱，容易报 NoClassDefFoundError 或连接后查不到 keyspace。
- 如果你的 Cassandra 是 4.x 版本，JDK 是 11+，只认 DataStax 4.x 驱动
- DataStax 驱动 jar 包不止一个：至少要
java-driver-core-4.x.x.jar+java-driver-mapper-annotations-4.x.x.jar（否则建表语句执行失败） - Simba 驱动的 URL 必须带
AuthMech=0或AuthMech=1，而 DataStax 的 URL 不需要这个参数
驱动配置里 class name 和 URL 模板怎么填？
填错 class name 是最常见连接失败原因——不是所有 jar 都能用 com.datastax.driver.core.Driver（那是旧版 3.x 的），新版统一用 com.datastax.oss.driver.internal.core.Driver。
- Driver Name：建议填
Cassandra-4.x，方便区分版本 - Class Name：
com.datastax.oss.driver.internal.core.Driver（DataStax 4.x）或com.simba.cassandra.jdbc42.Driver（Simba） - URL Template：
jdbc:cassandra://{host}[:{port}]/[{keyspace}]，注意结尾不加问号，也不加; - 默认端口填
9042，别写成 9160（Thrift 已废弃）
测试连接失败时先看哪几条错误信息？
别急着重试，先盯住错误提示里的关键词：
-
java.lang.ClassNotFoundException: com.datastax.oss.driver.internal.core.Driver→ jar 没加全，或 jar 版本与 class name 不匹配 -
Connection refused: connect→ 主机或端口不通，检查 Cassandra 是否真在运行（docker ps或netstat -an | grep 9042） -
Authentication failed→ 用户名密码错，或 Cassandra 没开认证（authenticator: AllowAllAuthenticator时应留空密码） -
No suitable driver found for jdbc:cassandra://...→ URL 模板格式不对，比如多了空格、用了中文冒号、或 host 写成了localhost:9042（应该只填localhost，端口走单独字段）
连接成功后看不到 keyspace 或表？
这是 Cassandra 的权限模型导致的——即使连上了，DBeaver 默认只显示当前登录用户有 DESCRIBE 权限的 keyspace。如果用的是 cassandra/cassandra 账号，得先确认它有没有被授权：
- 用 cqlsh 登录后执行：
LIST PERMISSIONS ON ALL KEYSPACES OF cassandra; - 若无结果，执行：
GRANT ALL PERMISSIONS ON ALL KEYSPACES TO cassandra; - DBeaver 刷新连接（右键连接 → Refresh）或重启软件，否则缓存可能卡住
- 某些版本 DBeaver 对宽列模型支持有限：不能双击展开表结构，需手动执行
DESCRIBE TABLE xxx查 schema
最容易被忽略的是 jar 包完整性——DataStax 4.x 驱动依赖多个子模块，只加 core 会连上但执行 DDL 失败；还有人把 {keyspace} 写进 URL 模板却没在连接设置里填值，结果连上去是空的。这些细节不细看日志，光靠“重试”解决不了。
