如何在docker compose中配置mysql_mysql compose配置方法_技术教程

Docker Compose 配置 MySQL 的核心是编写 docker-compose.yml，需指定镜像、端口映射（如3306:3306）、MYSQL_ROOT_PASSWORD 环境变量、数据卷挂载（mysql-data:/var/lib/mysql）及可选的初始化SQL和自定义my.cnf配置。

在 Docker Compose 中配置 MySQL，核心是编写一个 docker-compose.yml 文件，定义 MySQL 服务的镜像、端口、环境变量（尤其是 root 密码）、数据卷挂载和网络设置。配置不当容易导致容器启动失败、数据丢失或无法远程连接。

基础 MySQL 服务配置

这是最简可用的配置，适用于开发测试：

使用官方 mysql:8.0 或 mysql:5.7 镜像（推荐 8.0，注意客户端兼容性）
通过 MYSQL_ROOT_PASSWORD 必须设置 root 密码，否则容器会启动失败
映射宿主机端口（如 3306:3306），方便本地用客户端连接
挂载数据卷（mysql-data:/var/lib/mysql）确保容器重启后数据不丢失

示例 docker-compose.yml：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    container_name: my-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql
volumes:
  mysql-data:

添加初始化 SQL 脚本

希望容器首次启动时自动创建数据库、用户或导入表结构，可将 .sql 或 .sql.gz 文件挂载到 /docker-entrypoint-initdb.d/ 目录：

文件需放在宿主机目录（如 ./init/），并在 compose 中挂载
MySQL 启动时会按字母顺序执行该目录下所有 .sql 文件
仅在首次初始化空数据目录时生效，后续重启不会重复执行

追加配置示例：

volumes:
  - mysql-data:/var/lib/mysql
  - ./init/:/docker-entrypoint-initdb.d/

例如 ./init/01-create-db.sql 内容可为：
CREATE DATABASE IF NOT EXISTS app_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

自定义 MySQL 配置（my.cnf）

如需调整最大连接数、时区、字符集等，可通过挂载自定义配置文件实现：

准备 my.cnf（放在项目根目录或 ./conf/ 下）
挂载到容器内 /etc/mysql/conf.d/（MySQL 8.0 默认读取此目录下的 .cnf 文件）
避免覆盖默认配置，建议只写需要修改的项，例如：

[mysqld]
default-time-zone = '+08:00'
max_connections = 200
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

对应挂载写法：

volumes:
  - ./conf/my.cnf:/etc/mysql/conf.d/custom.cnf

连接与验证要点

配置完成后，启动并验证是否正常工作：

运行 docker-compose up -d 启动服务
检查日志：docker-compose logs -f mysql，确认无 ERROR 且出现 MySQL init process done. Ready for start up.
本地连接测试：mysql -h 127.0.0.1 -P 3306 -u root -p，输入密码即可登录
若应用容器需连接 MySQL，确保它们在同一个 Docker 网络（默认 compose 自动创建），直接用服务名 mysql 作 host（如 jdbc:mysql://mysql:3306/app_db）