DBeaver提示“Can't load driver class 'com.mysql.cj.jdbc.Driver'”说明MySQL JDBC驱动缺失,需进入驱动管理器检查【库】选项卡是否为空或路径无效;必须下载匹配服务端版本的8.0.x驱动(如8.0.33),手动添加jar包并确认驱动类为com.mysql.cj.jdbc.Driver,最后强制退出并重启DBeaver以刷新JVM类加载缓存。

你在DBeaver里点“测试连接”时弹出红色报错框,提示Can't load driver class 'com.mysql.cj.jdbc.Driver'或Maven artifact 'maven:/mysql:mysql-connector-java:RELEASE' not found,说明DBeaver根本没找到MySQL的JDBC驱动——这把连接数据库的“钥匙”压根没装进工具里。
确认驱动缺失并定位问题根源
打开DBeaver → 顶部菜单栏点击【数据库】→ 选择【驱动管理器】→ 在列表中找到MySQL驱动项 → 点击【编辑】→ 切换到【库】选项卡。如果该选项卡下为空白、显示“无库”或路径指向一个不存在的.jar文件,就坐实了驱动缺失的事实。
注意:不要只看驱动名称是否为MySQL,要重点检查【库】标签页里有没有真实可用的jar包。有些用户误以为“驱动已存在”,结果发现只是个空壳配置。
下载并手动添加正确的JDBC驱动
方法一:直接下载官方jar包(推荐)
访问MySQL官网Connector/J下载页 → 找到最新稳定版(如mysql-connector-java-8.0.33.jar)→ 下载Platform Independent版本 → 保存到本地清晰路径(例如D:\drivers\mysql-connector-java-8.0.33.jar)。
方法二:用DBeaver内置Maven拉取(仅限网络通畅且代理配置正确时)
在【驱动管理器】→ 【编辑MySQL驱动】→ 【库】选项卡 → 点击【添加文件】→ 选择【Maven坐标】→ 输入mysql:mysql-connector-java:8.0.33 → 点击【确定】。若提示“not found”,说明Maven源不可达或被拦截,立刻切回方法一。
【关键前提】必须使用8.0.x系列驱动匹配MySQL 8.x服务端,5.x驱动无法识别caching_sha2_password认证协议,会直接报错退出。
配置驱动类名与连接参数
第一步:右键新建连接 → 选择MySQL → 点击【下一步】
第二步:在【主设置】页填写主机、端口、数据库名、用户名、密码 → 向下滚动到【驱动设置】区域 → 手动将【驱动类】字段改为com.mysql.cj.jdbc.Driver(不是com.mysql.jdbc.Driver)
第三步:点击【测试连接】前,务必核对URL格式是否为jdbc:mysql://127.0.0.1:3306/testdb?useSSL=false&serverTimezone=Asia/Shanghai。缺少?useSSL=false参数可能导致握手阶段阻塞,尤其在内网开发环境。
这一步操作起来很简单,直接把文件拖进去就行。但如果你跳过驱动类名校验,DBeaver可能沿用旧缓存配置,导致即使jar包已加载,仍报找不到驱动类。
强制刷新驱动缓存并重启生效
完成上述配置后,不要直接点测试连接。
关闭所有连接窗口 → 顶部菜单【文件】→ 【退出】→ 完全退出DBeaver进程(任务管理器确认java.exe进程已结束)→ 重新启动DBeaver → 再次进入【驱动管理器】→ 检查MySQL驱动右侧是否显示绿色勾选标记和jar包路径 → 此时再新建连接并测试。
很多用户卡在最后一步:以为配置完就能连,结果因JVM类加载器未重载新jar而持续失败。强制退出是唯一可靠清缓存方式。











