TDengine 是高性能时序数据库，但在 macOS 上使用 DBeaver 连接时，很多同学会遇到 JDBC 驱动、类找不到、native 库加载失败等问题。本文总结了从驱动下载到配置连接的全流程，保证一次成功。

1. 下载正确的 JDBC 驱动

错误示例

很多人直接使用 DBeaver 默认下载驱动，会报：

原因：

• DBeaver 内置的 TDengine 3.3+ WebSocket 驱动依赖 Netty QUIC

• macOS 下 Maven 无法下载

• URL 中 ${packaging.type} 没被替换

正确做法

1. 手动下载 TDengine JDBC 3.6.3-dist jar：https://repo1.maven.org/maven2/com/taosdata/jdbc/taos-jdbcdriver/3.6.3/

2. 安装到 DBeaver：

• 打开 DBeaver → Database → Driver Manager

• 找到 TDengine → Edit

• 在 Libraries 标签页 → 点击 Add File

• 选择下载的 taos-jdbcdriver-3.6.3-dist.jar

• 删除其它自动下载的 Maven 依赖（如 netty、quic）

这样 DBeaver 就能使用本地驱动，不再依赖网络下载。

mac下使用restful驱动比较简单：restful对应的端口是6041，websocket对应的端口是6042

连接页面：

表格：

2. 修改驱动类

这个是其他错误的尝试遇到的

错误示例

原因：

• 3.2.7 驱动不包含 WebSocketDriver

• DBeaver 默认使用 3.3+ WebSocket 模板

正确做法

在 DBeaver Driver Manager → Edit → Driver Class：

3. 配置 JDBC URL

这本质也是驱动问题

错误示例

原因：

• REST / WebSocket URL 只支持 3.3+ WebSocket 驱动

• 3.2.7-native 驱动必须使用 native URL

正确做法

• URL 格式：

• 示例：

注意端口 6030 对应 TDengine 原生服务，6041 是 REST/WS 服务，不适用 3.2.7 驱动。