你将完成什么
本文用可照做的方式，带你在 Windows 11 / macOS 上安装 DBeaver（社区版），并成功连接到 MySQL 或 PostgreSQL。最后附上常见报错的排查清单，确保你能真正连上并跑出第一条查询。
准备清单（开始前先确认）
- 你已知道数据库地址（本机或远程）、端口、用户名、密码
- 如果是远程库：确认网络可达（同网段 / VPN / 云安全组已放行）
- 你有一个目标数据库：MySQL 5.7/8.x 或 PostgreSQL 12+（均可）
第 1 步：安装 DBeaver（Windows / macOS）
Windows 11：
- 进入 DBeaver 官网下载 Community 版本安装包（Installer / .exe）。
- 按向导安装，保持默认路径即可。
- 首次打开若弹窗提示工作区（Workspace）位置：建议选一个你容易备份的目录（例如 Documents/DBeaver）。
macOS：
- 下载 Community 版 .dmg。
- 把 DBeaver 拖到 Applications。
- 首次打开若提示“无法验证开发者”：到 系统设置 → 隐私与安全性 → 允许打开。
第 2 步：创建 MySQL 连接（最常见场景）
- 打开 DBeaver，左上角点击 新建连接（New Data Connection）。
- 选择 MySQL → 下一步。
- 填写连接信息：
- Host：例如 127.0.0.1 / localhost / 你的云数据库域名
- Port：默认 3306
- Data ：可先留空（能连上后再选库）
- User / Password：填你的账号密码
- 点击 Test Connection（测试连接）。
- 若提示下载驱动（Driver files missing）：选择 Download 自动下载。
- 测试通过后点击 Finish 完成创建。
第 3 步：创建 PostgreSQL 连接（数据分析/后端常用）
- 新建连接 → 选择 PostgreSQL。
- 常用参数：
- Host：本机 127.0.0.1 或远程地址
- Port：默认 5432
- Data ：通常必填（例如 postgres 或业务库名）
- User / Password：你的账号密码
- 测试连接 → 自动下载驱动 → Finish。
第 4 步：第一次查询与基础操作（保证你真的“能用”）
- 左侧导航找到连接 → 展开到库/表。
- 右键某张表 → View Data（查看数据）→ 选择前 200 行。
- 或新建 SQL 编辑器：右键连接 → SQL Editor → New SQL 。
- 示例查询：
- MySQL：SELECT NOW();
- PostgreSQL：SELECT NOW();
常见报错排查（按出现频率排序）
1）驱动下载失败 / 一直转圈
- 先重试一次；仍失败通常是网络无法访问驱动源。
- 可在 Driver 设置里更换镜像/手动添加驱动（公司网络常见）。
2）Connection timed out / 网络不通
- 确认 Host/Port 没写错：MySQL 默认 3306，PostgreSQL 默认 5432。
- 远程库需检查：云安全组/防火墙是否放行端口；公司网络是否需要 VPN。
- 如果数据库在 Docker：端口映射是否正确（例如 -p 3306:3306）。
3）Access denied for user / 认证失败
- 用户名/密码是否正确（注意大小写）。
- MySQL 常见：账号只允许本地登录，需要授予远程权限或限制来源 IP。
- PostgreSQL 常见：pg_hba.conf 规则未放行你的来源。
4）SSL 相关错误（尤其云数据库）
- 云数据库可能要求开启 SSL：在连接设置里启用 SSL，并按平台提示选择证书/模式。
- 如果你明确不需要 SSL（仅内网测试）：可尝试关闭 SSL（注意合规与安全要求）。
小建议：把连接配置做成可复用模板
- 连接命名建议：环境-业务-数据库类型（例如 prod-order-mysql）。
- 常用属性（时区/字符集）统一在连接属性里设置，减少“同样 SQL 不同结果”的坑。
- 重要：不要在共享截图里暴露密码、内网地址与敏感库名。
你可以直接照做的检查清单（1 分钟自检）
- 能 Test Connection 成功
- 能展开到某个数据库与表
- 能跑 SELECT NOW();
- 能查看表数据或执行一条简单查询
