必须用容器真实IP或宿主机映射端口替代localhost：填127.0.0.1+映射端口最可靠；填容器IP时端口须为内部监听端口（如3306/5432），不可填映射端口；同时需确认容器已运行、端口已暴露、数据库监听配置正确（如bind-address非127.0.0.1）、账号密码匹配。
要在DBeaver中稳定连接Docker容器内的数据库，必须绕过“localhost直连失败”这个最常卡住新手的坑——容器与宿主机网络隔离，直接填127.0.0.1或localhost必然报错Connection refused。你需要拿到容器在Docker网桥中的真实IP，或改用宿主机映射端口+回环地址的组合方式，二者路径不同，适用场景也不同。
确认数据库容器已运行并暴露端口
先执行docker ps，确保目标容器状态为Up，且PORTS列显示类似0.0.0.0:3306->3306/tcp这样的映射关系。如果只看到3306/tcp没带宿主机端口，说明未用-p参数启动，DBeaver无法从外部访问，必须重建容器。
若容器由docker-compose管理，检查docker-compose.yml中对应服务是否含ports:段，例如- "5432:5432"；缺失则添加后运行docker-compose up -d重启。
获取容器IP地址（适用于同一Docker网络内直连）
方法一：用inspect命令提取IP
运行docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <container_name_or_id></container_name_or_id>，输出类似172.17.0.2的IPv4地址。注意：该IP仅在Docker默认bridge网络下有效，若容器使用--network host或自定义网络，需对应调整命令中的Networks路径。
方法二：进容器查自身绑定地址
执行docker exec -it <container_name> ip addr show eth0 | grep 'inet ' | awk '{print $2}' | cut -d/ -f1</container_name>，直接读取容器内网卡配置。这一步能验证数据库进程是否真的监听在该IP上，避免因MySQL配置了bind-address=127.0.0.1导致外部不可达。
配置DBeaver连接参数（关键字段逐项核对）
第一步：打开DBeaver → 数据库 → 新建数据库连接 → 选择对应数据库类型（如MySQL、PostgreSQL）。
第二步：填写主机和端口
若已做端口映射（如-p 3306:3306），主机填127.0.0.1，端口填映射到宿主机的端口号（如3306）。这是最简单可靠的方式，无需处理Docker网络。
若需直连容器IP（如跨容器调用），主机填上一步获取的172.17.0.2这类地址，端口填容器内数据库实际监听端口（如MySQL默认3306，PostgreSQL默认5432）——【此处极易填错：不要填宿主机映射端口，要填容器内部端口】。
第三步：认证信息
用户名、密码必须与容器启动时通过-e MYSQL_ROOT_PASSWORD=xxx等环境变量设置的一致。PostgreSQL需确认是否用了-e POSTGRES_PASSWORD=xxx，SQL Server需核对-e SA_PASSWORD=xxx（注意SQL Server密码需含大小写字母+数字+特殊字符，否则容器启动失败）。
第四步：点击“测试连接”。成功则显示“Connected successfully”，失败则根据错误提示反向排查：Connection refused多为IP/端口错或防火墙拦截；Access denied多为账号密码不匹配；Unknown database多为数据库名不存在或未在连接URL中指定。
解决常见连接失败问题
问题1：测试连接时提示“Public Key Retrieval is not allowed”（MySQL 8.0+）
在DBeaver连接编辑页 → “驱动设置” → “SSL”选项卡 → 勾选“Allow public key retrieval”，或在JDBC URL末尾手动添加&allowPublicKeyRetrieval=true&useSSL=false。
问题2：PostgreSQL连接报“FATAL: password authentication failed for user”
检查容器日志：docker logs <container_name></container_name>，确认初始化时是否打印了默认密码；若用postgres:alpine镜像，密码可能为空，需在连接时留空密码字段，或启动时显式指定-e POSTGRES_PASSWORD=mysecretpass。
问题3：DBeaver提示“Driver not found”
首次连接某类数据库（如openGauss、DM8）时，DBeaver默认不带对应JDBC驱动。点击连接配置页左下角“Edit Driver Settings” → “Download/Update” → 搜索数据库名 → 勾选官方驱动下载安装。国产数据库务必从官网下载最新JDBC包，手动添加到驱动库路径。
