解决 Docker-compose 创建容器时数据库连接失败的问题-JavaScript中文网-JavaScript教程资源分享门户

Docker-compose 是一个非常方便的工具，可以帮助我们快速创建多个 Docker 容器，并通过一个文件来统一管理它们的配置和运行。在实际开发中，我们经常会用到 Docker-compose 来搭建整个项目的开发环境。但是，在使用 Docker-compose 创建容器时，有时候会遇到数据库连接失败的问题，这篇文章将为大家详细介绍如何解决这个问题。

问题描述

在使用 Docker-compose 创建一个带有数据库的容器时，我们可能会遇到以下报错信息：

Error: Connection refused

这个报错信息很明显，就是无法连接到数据库，造成这个问题的原因可能有很多。下面我们将分析可能的原因，并提供解决方法。

可能原因

网络问题：容器无法连接到数据库，可能是因为容器所在的网络无法访问到数据库。
数据库配置问题：容器无法使用正确的用户名和密码连接到数据库，可能是因为我们在 Docker-compose 文件里写错了数据库的用户名和密码。
端口映射问题：容器无法访问数据库的端口，可能是因为我们没有正确地将数据库的端口映射到主机端口。

解决方法

1. 网络问题

首先，我们需要检查容器是否能够连通数据库所在的网络。我们可以在容器里运行 ping 命令来测试网络是否正常：

// javascriptcn.com 代码示例
web:
  container_name: web
  image: nginx:latest
  networks:
    - backend

db:
  container_name: db
  image: mysql:5.7
  networks:
    - backend

networks:
  backend:

$ docker-compose run web ping db
PING db (172.20.0.2): 56 data bytes
64 bytes from db.backend (172.20.0.2): icmp_seq=0 ttl=64 time=0.184 ms
64 bytes from db.backend (172.20.0.2): icmp_seq=1 ttl=64 time=0.173 ms
...

通过 ping 命令，我们可以看到容器成功连通了数据库所在的网络。如果无法连通，则需要检查容器与数据库之间的网络配置。

2. 数据库配置问题

其次，我们需要检查 Docker-compose 文件里数据库的用户名和密码是否正确。我们可以在容器里运行 mysql 命令来测试用户名和密码是否可以连接到数据库：

// javascriptcn.com 代码示例
web:
  container_name: web
  image: nginx:latest
  networks:
    - backend
  depends_on:
    - db

db:
  container_name: db
  image: mysql:5.7
  environment:
    - MYSQL_ROOT_PASSWORD=root
    - MYSQL_DATABASE=mydb
    - MYSQL_USER=user
    - MYSQL_PASSWORD=password
  ports:
    - "3306:3306"
  networks:
    - backend

networks:
  backend:

$ docker-compose run web mysql -h db -u user -p password
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 15
Server version: 5.7.35 MySQL Community Server (GPL)

...

mysql>

通过 mysql 命令，我们可以看到容器成功连接到了数据库，并打开了 MySQL 命令行终端。如果无法连接，则需要修改 Docker-compose 文件里的数据库配置。

3. 端口映射问题

最后，我们需要检查数据库所在的端口是否正确映射到了主机上。我们可以通过在主机上运行 telnet 命令来测试数据库端口是否可以正常访问：

// javascriptcn.com 代码示例
web:
  container_name: web
  image: nginx:latest
  networks:
    - backend
  depends_on:
    - db

db:
  container_name: db
  image: mysql:5.7
  environment:
    - MYSQL_ROOT_PASSWORD=root
    - MYSQL_DATABASE=mydb
    - MYSQL_USER=user
    - MYSQL_PASSWORD=password
  ports:
    - "3306:3306"
  networks:
    - backend

networks:
  backend:

$ telnet localhost 3306
Trying ::1...
Connected to localhost.
Escape character is '^]'.

如果成功连接到了数据库，我们会看到 Connected to localhost 的提示。如果无法连接，则需要检查 Docker-compose 文件中的端口映射是否正确。

总结

通过上面的分析及解决方法，我们可以解决 Docker-compose 创建容器时数据库连接失败的问题。在开发过程中，我们一定要留意网络、配置及端口映射这些细节，确保容器能够正常连接到数据库。希望这篇文章能够对你有所帮助，谢谢！

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/653ddaaf7d4982a6eb7833cb