Docker容器无法连接本地数据库的解决方案

当Docker容器无法连接主机上的数据库时，通常涉及网络配置问题。以下是常见原因和解决方案：

常见原因

1. 网络隔离导致容器无法访问主机服务
2. 数据库服务未监听正确IP地址
3. 防火墙/安全组规则阻止访问
4. 数据库用户权限不足

解决方案

1. 使用正确的host地址

在容器内连接主机数据库时，不能使用localhost或127.0.0.1，因为这会指向容器自身。应该使用：

• Linux/macOS: host.docker.internal
• Windows: host.docker.internal
• 或者使用主机实际IP地址

2. 确保数据库监听所有接口

检查数据库配置是否监听所有网络接口：

• MySQL: 检查bind-address是否为0.0.0.0
• PostgreSQL: 检查listen_addresses是否为'*'
• MongoDB: 检查net.bindIp是否为0.0.0.0

3. 使用正确的网络模式

启动容器时使用--network host模式可以直接使用主机网络：

docker run --network host your_image

4. 检查防火墙设置

确保主机防火墙允许数据库端口通信：

# Linux示例
sudo ufw allow 3306/tcp  # MySQL
sudo ufw allow 5432/tcp  # PostgreSQL

5. 检查数据库用户权限

确保数据库用户有从远程主机连接的权限：

-- MySQL示例
CREATE USER 'username'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON database.* TO 'username'@'%';
FLUSH PRIVILEGES;

6. 使用Docker自定义网络

创建自定义网络并连接容器：

docker network create my-network
docker run --network my-network --name my-db -e MYSQL_ROOT_PASSWORD=password -d mysql
docker run --network my-network -it your_application_image

调试步骤

1. 在容器内测试网络连通性：

   docker exec -it your_container ping host.docker.internal
   

2. 测试端口连通性：

   docker exec -it your_container telnet host.docker.internal 3306
   

3. 检查容器日志：

   docker logs your_container
   

4. 检查数据库日志中的连接尝试记录

通过以上方法，您应该能够解决Docker容器连接本地数据库的问题。