文章目录一、DBeaver 下载与安装1. 下载2. 安装步骤二、配置 MySQL 连接1. 启动 DBeaver2. 新建数据库连接3. 选择数据库类型4. 填写连接信息5. 下载驱动6. 连接成功三、常见连接报错及解决方案报错现象 原因一端口号填写错误 原因二MySQL 的 bind-address 仅限本地 原因三本机未安装 MySQL 服务 原因四云服务器防火墙/安全组未放行端口报错现象解决方法四、附后端项目启动说明DBeaver一款开源的通用数据库管理工具支持 MySQL、PostgreSQL、Oracle 等多种数据库界面直观适合开发人员日常查询和管理数据。MySQL目前最流行的开源关系型数据库之一广泛应用于各类 Web 应用和后端系统。本文将从零开始带你完成 DBeaver 的安装、MySQL 连接的配置以及常见报错的解决方法。一、DBeaver 下载与安装1. 下载官网地址https://dbeaver.io/download/打开官网点击下载。2. 安装步骤下载完成后双击程序安装。选择中文点击 OK。直接点击“下一步”。勾选“我接受协议”点击“下一步”。按照需求选择安装类型推荐选择“为本用户安装”。一直点击“下一步”直到出现“安装”按钮。等待安装完成可勾选“创建桌面快捷方式”。二、配置 MySQL 连接前置条件确保本地或远程已部署 MySQL 数据库服务且服务处于运行状态。1. 启动 DBeaver双击打开 DBeaver首次启动会弹出欢迎弹框直接关闭即可。2. 新建数据库连接点击工具栏中的“新建数据库连接”按钮插头图标。3. 选择数据库类型在弹出的窗口中选择MySQL点击“下一步”。4. 填写连接信息输入数据库的连接信息包括服务器地址Host、端口Port、数据库名称Database、用户名Username和密码Password然后点击“测试连接”。5. 下载驱动若提示缺少驱动点击“下载”即可自动获取。等待驱动下载完成。6. 连接成功测试连接显示成功后点击“完成”。回到 DBeaver 主界面在左侧导航栏即可看到已连接的数据库可展开查看表、视图等对象并进行数据操作。三、常见连接报错及解决方案报错现象Connection refused: getsockopt Communications link failure The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server. Connection refused: getsockopt 原因一端口号填写错误检查方式右键点击已创建的连接 → 选择“编辑连接”确认端口号是否与 MySQL 实际端口一致默认3306。右键点击编辑链接确认端口配置是否正确。 原因二MySQL 的bind-address仅限本地MySQL 默认为了安全往往只绑定了127.0.0.1只允许本机访问。如果用 IP 地址非127.0.0.1或域名连接就会被拒绝。排查步骤在 MySQL 服务器上执行# 登录 MySQLmysql-uroot-p# 执行以下 SQL 查看绑定地址SHOW VARIABLES LIKEbind_address;若结果为127.0.0.1说明只允许本机访问。你的 DBeaver 不在同一台机器上或者虽然是同一台但填的是局域网 IP如192.168.x.x都会报拒绝。解决方案修改 MySQL 配置文件路径参考/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/my.cnf找到bind-address 127.0.0.1改为bind-address 0.0.0.0重启 MySQL 服务sudo systemctl restart mysql 原因三本机未安装 MySQL 服务若本地根本没有安装 MySQL需要先安装。安装步骤访问官网下载 MySQL Installerhttps://dev.mysql.com/downloads/installer/选择mysql-installer-community版本一路点击“下一步”。关键配置项Choosing a Setup Type 选Server onlyDownload选择第一个即然后一直下一步Authentication Method 选第一个Use Strong Password EncryptionAccounts and Roles Root 密码设为与项目配置保持一致Windows Service 勾选Configure MySQL Server as a Windows Service服务名默认MySQL80一直下一步等待下载完成。安装完成后用 MySQL 命令行创建数据库按Win R→ 输入cmd→ 回车执行以下命令mysql-uroot-p123456CREATEDATABASE数据库名称DEFAULTCHARACTERSETutf8mb4;EXIT;回到 DBeaver 重新连接新建连接 → MySQLHost:localhostPort:3306Username:rootPassword:123456点击Test Connection测试通过后点击完成 原因四云服务器防火墙/安全组未放行端口检查方式在客户端机器执行telnet 服务器IP 3306若提示Connection refused则端口被拦截。解决方案Linux 系统检查firewalld或iptables规则是否放行3306端口。云厂商阿里云/腾讯云/AWS前往控制台安全组→入方向添加规则端口3306授权对象0.0.0.0/0测试用或指定客户端 IP。报错现象Public Key Retrieval is not allowed解决方法在 DBeaver 连接编辑窗口中右键点击已创建的连接 → 选择“编辑连接”选项-”数据库“一栏中添加如下内容mysql?allowPublicKeyRetrievaltrue四、附后端项目启动说明后端启动时会自动执行schema.sql建表并通过DataInitializer写入示例数据。完成后即可在 DBeaver 中查看到完整的表结构和数据。您好我是肥晨。欢迎关注我获取前端/AI学习资源日常分享技术变革生存法则行业内幕洞察先机。