Docker Compose 部署 Spring Boot 连接 MySQL 失败？Exit status 1 错误解决指南

在使用 Docker Compose 部署 Spring Boot 应用并连接 MySQL 数据库时，你可能会遇到 "Exit status 1" 的错误，并伴随着 "Caused by: java.net.ConnectException: Connection refused" 的错误信息。这通常意味着你的 Spring Boot 应用无法成功连接到 MySQL 数据库。

导致这个问题的原因有很多，我们来逐一分析。

首先，MySQL 数据库容器可能没有正常启动 。Docker Compose 虽然可以帮助我们一键启动多个容器，但每个容器的启动过程是独立的。如果 MySQL 容器的镜像存在问题，或者启动过程中出现错误，那么它就无法正常提供服务。你可以通过 docker-compose ps 命令查看所有容器的状态，如果 MySQL 容器的状态不是 "Up"，就说明它没有正常启动。这时，你可以使用 docker-compose logs mysql 命令查看 MySQL 容器的日志，找到启动失败的原因。

其次，你的 Spring Boot 应用可能使用了错误的数据库连接配置 。在 Docker Compose 环境中，容器之间是通过服务名称来互相访问的。这意味着你的 Spring Boot 应用应该使用 mysql 作为数据库的主机名，而不是 localhost 或 127.0.0.1。你需要检查你的 application.properties 或 application.yml 文件，确保 spring.datasource.url 属性的值是 jdbc:mysql://mysql:3306/你的数据库名称。

另外，网络连接问题也可能导致连接失败 。Docker Compose 会为你的应用创建一个独立的网络，所有容器都在这个网络中。但是，如果网络配置出现问题，例如 DNS 解析失败，那么你的 Spring Boot 应用就无法找到 MySQL 容器。你可以使用 docker network ls 命令查看 Docker 网络列表，并使用 docker network inspect <网络名称> 命令查看网络详情，确认你的应用和 MySQL 容器是否在同一个网络中，并且网络配置正确。

最后，Spring Boot 应用的启动速度可能比 MySQL 容器快 。MySQL 容器启动后，需要一些时间才能完成初始化并开始提供服务。如果你的 Spring Boot 应用在 MySQL 容器启动完成之前就尝试连接数据库，就会导致连接被拒绝。为了解决这个问题，你可以让 Spring Boot 应用等待一段时间再尝试连接数据库，或者使用一些特殊的配置，例如 spring.datasource.initialization-mode=always 和 spring.datasource.continue-on-error=true，让 Spring Boot 应用在数据库启动完成后再初始化数据源。

解决 "Exit status 1" 错误的步骤

1. 检查 MySQL 容器状态: 使用 docker-compose ps 命令查看 MySQL 容器是否正在运行。如果状态不是 "Up"，使用 docker-compose logs mysql 查看日志，找到启动失败的原因。
2. 检查数据库连接配置: 确保 spring.datasource.url 属性的值是 jdbc:mysql://mysql:3306/你的数据库名称，并且没有被其他配置文件覆盖。
3. 检查网络连接: 使用 docker network ls 和 docker network inspect <网络名称> 命令查看网络配置，确保应用和数据库容器在同一个网络中，并且网络配置正确。
4. 等待数据库启动完成: 可以尝试在 Spring Boot 应用中添加延迟启动机制，或者使用 spring.datasource.initialization-mode=always 和 spring.datasource.continue-on-error=true 配置。
5. 重启 Docker Compose 服务: 如果以上步骤都没有解决问题，可以尝试重启 Docker Compose 服务：docker-compose down 和 docker-compose up -d。

常见问题及解答

1. 为什么我的 MySQL 容器无法启动？

可能的原因有很多，例如镜像存在问题、端口冲突、配置文件错误等等。你需要查看 MySQL 容器的日志，找到具体的错误信息，并根据错误信息进行排查。

2. 如何确保 Spring Boot 应用读取正确的数据库连接配置？

Spring Boot 应用会按照一定的顺序加载配置文件，例如 application.properties、application.yml、环境变量等等。你需要了解 Spring Boot 的配置加载机制，并确保你的数据库连接配置在正确的配置文件中，并且没有被其他配置文件覆盖。

3. 如何检查 Docker Compose 的网络配置？

可以使用 docker network ls 命令查看 Docker 网络列表，并使用 docker network inspect <网络名称> 命令查看网络详情，例如网关、子网掩码、DNS 服务器等等。

4. 如何让 Spring Boot 应用等待数据库启动完成？

可以使用 spring.datasource.initialization-mode=always 和 spring.datasource.continue-on-error=true 配置，或者在 Spring Boot 应用中添加延迟启动机制，例如使用 Thread.sleep() 方法。

5. 重启 Docker Compose 服务有什么作用？

重启 Docker Compose 服务可以重新创建所有容器和网络，并重新加载配置文件。这有时可以解决一些由于配置错误或网络问题导致的连接失败问题。

希望以上内容能够帮助你解决 "Exit status 1" 错误，并成功连接到 MySQL 数据库。记住，在实际操作中，需要根据具体情况分析错误原因，并尝试不同的解决方案。