大多数部署失败源于配置文件语法错误、数据卷权限不足或网络连通性误解，建议优先查看容器日志定位具体报错。

命令速用版

遇到启动失败，先执行以下命令查看状态和日志，不要盲目重启：

docker-compose ps
 docker-compose logs mysql
 docker inspect mysql

若提示配置文件权限问题，可尝试修复挂载文件权限：

chmod 644 /path/to/your/my.cnf
 chmod go-w /path/to/your/my.cnf

为什么会这样

MySQL 镜像对启动环境有严格要求。首先，YAML 配置文件对缩进非常敏感，混用 Tab 和空格会导致解析失败。其次，MySQL 启动时会读取特定目录（如/etc/mysql/conf.d/），如果通过 volumes 挂载了父目录但宿主机缺少子目录，容器内就会报错找不到目录。此外，容器网络是隔离的，容器内的 localhost 指向容器自身而非宿主机，应用容器连接数据库时需使用服务名。最后，MySQL 初始化需要时间，depends_on 仅保证容器启动顺序，不保证数据库服务已就绪。

分步处理

1. 检查配置文件语法
确保 docker-compose.yml 使用空格缩进（通常 2 空格），避免使用 Tab。环境变量中的密码若包含特殊字符或纯数字，建议加双引号强制视为字符串，防止被解析为布尔值或整数。

2. 核对挂载目录
若配置了 volumes 挂载配置文件，确保宿主机对应路径存在。例如挂载/etc/mysql 时，宿主机目录需包含 conf.d 子目录，否则启动会报"Can't read dir"错误。若不需要自定义配置，可暂时注释掉配置挂载测试。

3. 修正文件权限
MySQL 拒绝加载权限过开的配置文件。确保挂载的 my.cnf 等文件权限为 644，且不可被其他用户写入，否则会被忽略导致端口或配置不生效。

4. 调整网络与依赖
应用连接数据库时，host 应填写 compose 中的服务名（如 mysql）而非 localhost。若应用启动报错连接拒绝，需在应用层增加重试机制，因为 depends_on 不等待数据库初始化完成。

怎么验证是否生效

容器启动后，执行docker-compose ps确认状态为 Up。进入容器内部测试连接：

docker exec -it mysql mysql -uroot -p

从应用容器测试网络连通性：

docker exec -it app_container ping mysql
 docker exec -it app_container telnet mysql 3306

若日志无报错且能成功登录，说明部署生效。

常见坑

1. 密码修改不生效
若数据卷已存在数据，修改环境变量中的密码不会生效，需清空数据目录或进入数据库手动修改。

2. 依赖启动陷阱
depends_on 仅等待容器启动，不等待服务就绪。MySQL 初始化可能需 10-30 秒，应用需实现重试逻辑。

3. 本地连接误区
容器内访问数据库不能用 localhost，需使用 compose 定义的服务名；宿主机访问需映射端口。

4. 配置文件被忽略
若日志提示"World-writable config file is ignored"，说明配置文件权限过大，需移除其他用户写权限。

参考来源

• Docker Compose 部署 MySQL 失败：为何出现"mysqld: Can't read dir of '/etc/mysql/conf.d/'"错误？
• Docker 部署 MySQL，这 10 个坑你不踩才怪 (Docker 部署篇)
• Docker-Compose 部署 MySQL 遇到错误如何排查？
• docker compose 对 mysql 的编排不生效
• Docker 容器项目无法访问 MySQL 的问题排查与解决策略
• Docker-compose 运行 MySQL 连接不上 - 阿里云开发者社区
• 排查并解决 Docker 中 MySQL 连接失败 - 开发者社区 - 阿里云