必须完成安装→配置Java环境→新建连接→下载驱动→测试连通五环节;Java需JDK 17/21,DBeaver安装版强制依赖系统级JDK;远程MySQL需改bind-address、授权用户、放行3306端口。

要在Windows系统上用DBeaver免费管理MySQL、PostgreSQL、SQLite等数据库,必须完成安装→配置Java环境→新建连接→下载驱动→测试连通这五个不可跳过的环节,漏掉任一环都会导致“Access denied”或“Connection refused”报错。
确认Java环境是否就绪
打开CMD,输入 java -version 回车,必须看到输出中包含 17 或 21 ——DBeaver 26.x已不再兼容JDK 11,也不支持JDK 22,只认准JDK 17/21。
若提示“不是内部或外部命令”,说明未安装Java或PATH未配置;此时需前往Eclipse Temurin官网下载JDK 17并完整安装,不能只解压zip包。
⚠️ 注意:DBeaver安装包虽自带OpenJDK,但仅限便携版可用;Windows安装版【强制依赖系统级JDK 17/21】,否则首次启动即闪退。
安装DBeaver并初始化中文界面
从官网 https://dbeaver.io/download/ 下载 dbeaver-ce-26.1.5-windows-x86_64.exe(非zip版),双击运行。
语言选“简体中文”→勾选“我接受”→安装类型选“所有用户安装”→路径避免含中文、空格或特殊字符(如D:\DBTools\DBeaver)→务必勾选“Add DBeaver to PATH”和“Create desktop shortcut”。
安装完立即勾选“Run DBeaver”,首次启动时工作区保持默认路径 C:\Users\[用户名]\dbeaver-data 即可。
若菜单仍是英文,立刻进 Window → Preferences → User Interface → Appearance → Language 改为“Chinese(Simplified)”,改完必须重启软件才生效。
新建MySQL连接并自动下载驱动
顶部菜单栏点击 数据库 → 新建连接(或按 Ctrl+Shift+N)→在搜索框输入 MySQL→选中后点“下一步”。
填写连接参数:
主机填 127.0.0.1(本地)或虚拟机IP(远程);
端口填 3306;
数据库名可留空;
用户名和密码必须与MySQL中实际账号完全一致——【空密码会导致Access denied using password: NO】。
勾选“保存密码”,点击“测试连接”。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
此时会弹出驱动下载窗口,点击“下载”,等待进度条走完(约30秒),不要关闭窗口或切走焦点。
驱动下载完成后,“测试连接”按钮变亮,点击它;看到绿色“已连接”提示即成功,点“完成”保存连接。
连接远程MySQL的三道硬门槛
方法一:放开MySQL监听地址
登录虚拟机,编辑 /etc/my.cnf,确保存在 bind-address = 0.0.0.0;没有就手动添加,保存后执行 sudo systemctl restart mysql。
方法二:授权远程用户
在MySQL中执行:
CREATE USER 'dev'@'%' IDENTIFIED BY 'StrongPass123!';
GRANT ALL ON *.* TO 'dev'@'%';
FLUSH PRIVILEGES;
方法三:放行3306端口
若虚拟机启用了firewalld,运行:
sudo firewall-cmd --permanent --add-port=3306/tcp
sudo firewall-cmd --reload
以上三步缺一不可。只要其中一步没做,DBeaver测试连接就会卡在“Connecting…”或直接报错“Host 'xxx' is not allowed to connect”。
快速验证连接是否真正可用
在左侧数据库导航树中,展开你刚建好的连接→展开 Schemas→双击任意一张表(如 users)。
中间区域自动切换到数据视图,显示表格全部行;若看到真实数据且无红色报错,说明连接、认证、权限、网络四重校验全部通过。
此时可直接在上方SQL编辑器里写 SELECT * FROM users WHERE id = 1;,按 Ctrl+Enter 执行——查询结果实时返回,整个流程闭环完成。










