Docker 容器内 Spring Boot 和 MySQL 通信故障排除全指南

Docker 容器内 Spring Boot 和 MySQL 通信故障的故障排除指南

在 Docker 容器中部署 Spring Boot 应用程序和 MySQL 数据库时，沟通链接故障是一个常见的问题。本文提供了一个全面的指南，用于识别和解决此问题。

## 问题

当 Spring Boot 应用程序无法与 MySQL 数据库建立连接时，就会出现沟通链接故障错误。这可能会导致应用程序启动失败或运行时行为不稳定。

## 解决方案步骤

1. 检查网络配置

Docker Compose 使用默认网络连接容器。确保容器中的应用程序和数据库位于同一网络中。避免定义自定义网络，除非有明确的原因。

2. 调整 Docker 依赖性

Docker Compose 的 depends_on 仅确保容器按顺序启动。它不保证依赖的服务已准备就绪。在 Spring Boot 应用程序中实现重试机制，以等待 MySQL 容器完全初始化。

3. 验证 MySQL 配置

Docker Compose 配置应设置包含必要环境变量的 MySQL 容器。检查数据库配置是否正确，包括数据库名称、用户名和密码。

4. 排除防火墙或安全设置

由于容器位于同一主机上，因此防火墙或安全设置不太可能导致问题。但是，值得检查是否有任何可能干扰的本地防火墙规则。

5. 检查 Docker Compose 配置

docker-compose.yml 文件应正确配置服务定义和端口映射。确保 MySQL 的端口映射允许应用程序访问数据库。

6. 其他检查

• 确保 MySQL 容器正在运行并接受连接。
• 验证应用程序中的数据库连接配置是否正确。
• 尝试手动连接 MySQL 容器，以查看错误是否与 Docker Compose 无关。

## 示例代码

docker-compose.yml

version: '3.7'

services:
  mysql:
    image: mysql:latest
    ports:
      - "3306:3306"
    environment:
      MYSQL_DATABASE: wallet_microservice
      MYSQL_ROOT_PASSWORD: root
      MYSQL_USER: username
      MYSQL_PASSWORD: password
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/wallet_microservice?useSSL=false
      SPRING_DATASOURCE_USERNAME: username
      SPRING_DATASOURCE_PASSWORD: password
    depends_on:
      - mysql

application.properties

spring.datasource.url=jdbc:mysql://mysql:3306/wallet_microservice
spring.datasource.username=username
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

## 结论

通过遵循这些故障排除步骤，您可以识别并解决 Docker 容器中 Spring Boot 和 MySQL 之间的通信链接故障问题。重要的是要理解潜在的原因，并系统地排除问题，以确保应用程序稳定运行。

## 常见问题解答

1. 如何重试 MySQL 连接？

在应用程序中使用重试机制，例如：

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;

@Service
public class DatabaseService {

    @Retryable(maxAttempts = 3, backoff = @Backoff(delay = 1000, multiplier = 1.5))
    public void connectToDatabase() {
        // Connect to MySQL
    }
}

2. 如何验证 MySQL 容器的健康状况？

使用 docker exec 命令连接到容器并执行 mysql -u root -p 命令。输入密码后，您应该能够访问数据库提示符。

3. 如何手动连接到 MySQL 容器？

使用 docker exec 命令连接到容器并执行以下命令：

mysql -u username -p password wallet_microservice

4. 为什么 depends_on 不足以确保 MySQL 已准备好？

depends_on 仅确保服务按顺序启动。它不保证依赖的服务已完成初始化并已准备好接受连接。

5. 如何检查防火墙或安全设置？

在主机上运行以下命令以检查防火墙规则：

sudo ufw status

如果您看到阻止容器端口的规则，请将它们禁用或调整。