Docker环境下mysql_database与klassy_docker_build连接配置咨询

核心问题定位 #

容器内应用无法连接MySQL服务，通常是网络寻址错误、服务启动顺序问题、数据库权限配置或应用连接串配置错误导致，以下是具体调整方案：

1. 修正数据库连接地址 #

容器内的localhost指向容器自身，而非宿主机器或MySQL容器，必须使用Docker Compose中定义的MySQL服务名mysql_database作为连接主机：

• 应用连接串示例（以JDBC为例）：

  jdbc:mysql://mysql_database:3306/your_database_name?useSSL=false&serverTimezone=UTC
  

• 确保应用配置文件（如application.properties、config.js等）中已替换掉localhost/127.0.0.1为mysql_database。

2. 确保服务在同一网络 #

Docker Compose默认会为项目创建专属网络，若你自定义了网络，需确认两个服务都加入同一网络：

# docker-compose.yml 示例配置
networks:
  app-network:
    driver: bridge

services:
  mysql_database:
    # 其他配置
    networks:
      - app-network
  klassy_docker_build:
    # 其他配置
    networks:
      - app-network

（若未自定义网络，默认[项目名]_default网络会自动包含所有服务，无需额外配置）

3. 控制服务启动顺序 #

应用可能在MySQL完成初始化前发起连接，导致失败。需添加依赖配置+就绪等待脚本：

• 在docker-compose.yml中为应用服务添加depends_on，并引入等待脚本（如wait-for-it.sh）：

  klassy_docker_build:
    # 其他配置
    depends_on:
      - mysql_database
    # 假设wait-for-it.sh已放在应用根目录
    command: ["./wait-for-it.sh", "mysql_database:3306", "--", "java -jar your-app.jar"]
  

• 若不想使用外部脚本，也可在MySQL服务中添加healthcheck，让Compose自动等待服务就绪：

  mysql_database:
    # 其他配置
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      timeout: 20s
      retries: 10
  

4. 调整MySQL权限与绑定地址 #

MySQL默认可能仅允许本地连接，需修改配置允许容器网段访问：

• 在docker-compose.yml的MySQL服务中添加启动参数，绑定所有地址并设置兼容认证插件：

  mysql_database:
    # 其他配置
    command: --default-authentication-plugin=mysql_native_password --bind-address=0.0.0.0
  

• 确保初始化的数据库用户支持远程连接（而非仅localhost），可通过初始化SQL脚本实现：

  -- 初始化脚本（如init.sql，挂载到/docker-entrypoint-initdb.d/目录）
  CREATE USER 'your_user'@'%' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%';
  FLUSH PRIVILEGES;
  

5. 验证MySQL容器配置 #

• 确认docker-compose.yml中MySQL的环境变量正确，应用连接时需使用这些配置的账号密码：

  mysql_database:
    environment:
      MYSQL_ROOT_PASSWORD: root123
      MYSQL_DATABASE: your_database
      MYSQL_USER: app_user
      MYSQL_PASSWORD: app_pass123
  

• 检查MySQL容器端口是否正常，内部连接使用容器默认的3306端口，宿主端口映射（如3306:3306）仅用于本地连接，不影响容器间通信。

内容的提问来源于stack exchange，提问作者Shakib Ahmed