解决 Docker Compose 中 MySQL 卷绑定问题

当使用 Docker Compose 部署 MySQL 时遇到卷绑定问题，这通常是由于权限或路径配置不当导致的。以下是常见问题和解决方案：

常见错误表现

1. Error response from daemon: invalid volume specification
2. Permission denied 错误
3. 容器启动后数据未持久化

解决方案

1. 检查卷路径格式

确保 docker-compose.yml 中的卷路径格式正确：

volumes:
  - ./mysql-data:/var/lib/mysql  # 相对路径
  - /absolute/path/mysql-data:/var/lib/mysql  # 绝对路径

2. 权限问题处理

MySQL 容器默认以 mysql 用户运行(UID 999)，如果使用本地目录作为卷：

# 创建数据目录
mkdir -p ./mysql-data

# 设置适当权限(选择一种方式)
# 方式1: 更改所有权
sudo chown -R 999:999 ./mysql-data

# 方式2: 开放完全权限(开发环境可用)
sudo chmod -R 777 ./mysql-data

3. 正确的 Docker Compose 配置示例

version: '3.8'

services:
  mysql:
    image: mysql:8.0
    container_name: mysql_db
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: your_database
      MYSQL_USER: your_user
      MYSQL_PASSWORD: your_password
    volumes:
      - mysql-data:/var/lib/mysql
      - ./mysql-config:/etc/mysql/conf.d
    ports:
      - "3306:3306"
    restart: unless-stopped

volumes:
  mysql-data:

4. 使用命名卷替代绑定挂载

如果不想处理本地目录权限问题，可以使用 Docker 管理的命名卷：

volumes:
  - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

5. 检查 SELinux 限制(仅限 Linux)

如果使用 SELinux，可能需要添加 :z 或 :Z 标志：

volumes:
  - ./mysql-data:/var/lib/mysql:z

6. Windows/Mac 特定问题

在 Windows 或 Mac 上使用 Docker Desktop 时：

1. 确保目录已共享(Docker Desktop 设置 → Resources → File Sharing)
2. 避免使用 Windows 风格的路径(使用 /c/Users/... 而不是 C:\Users\...)

调试技巧

1. 检查容器日志：docker logs <container_name>
2. 进入容器检查目录权限：docker exec -it <container_name> bash
3. 尝试使用 --privileged 模式临时测试是否是权限问题

通过以上方法，您应该能够解决大多数 Docker Compose 中 MySQL 的卷绑定问题。