如何在Laravel Sail的docker-compose.yml中添加MySQL配置并解决启动报错

该错误是MySQL 8.0官方镜像的默认配置与你自定义配置挂载方式冲突导致的：官方镜像默认会创建/var/lib/mysql-files目录作为secure_file_priv参数的取值，直接覆盖/etc/mysql/my.cnf后要么丢失了该目录的自动创建逻辑，要么你自定义配置中该路径没有对应目录/权限，导致启动失败。

• 步骤1：调整配置挂载路径，不要直接覆盖全局my.cnf，挂载到官方预留的自定义配置目录/etc/mysql/conf.d/下即可，该目录下所有.cnf后缀的文件都会被自动加载，优先级高于默认配置，不会破坏原生逻辑：
  调整docker-compose.yml中mysql服务的volumes配置：

  volumes:
    - 'sailmysql:/var/lib/mysql'
    # 挂载到conf.d目录，自定义配置文件名可随意修改，只要后缀为.cnf即可
    - './docker/8.0/my.cnf:/etc/mysql/conf.d/my-custom.cnf'
  

• 步骤2：二选一解决secure_file_priv报错问题：
  • 方案A：在你的自定义my.cnf中显式指定secure_file_priv的取值：

  [mysqld]
  # 此处添加你需要的自定义配置，比如字符集、最大连接数等
  character-set-server = utf8mb4
  max_connections = 1000
  
  # 解决secure_file_priv报错，三个取值任选其一即可：
  # NULL：禁止导入导出操作，生产环境推荐
  # 空值""：不限制目录，测试环境方便调试用
  # 具体路径：仅允许在指定目录下操作
  secure_file_priv = NULL
  

  • 方案B：额外挂载mysql-files卷，无需修改my.cnf配置：
    首先在mysql服务的volumes中新增卷挂载：

  volumes:
    - 'sailmysql:/var/lib/mysql'
    - 'sailmysql-files:/var/lib/mysql-files'
    - './docker/8.0/my.cnf:/etc/mysql/conf.d/my-custom.cnf'
  

  再到docker-compose.yml最外层的volumes配置段，新增sailmysql-files的声明：

  volumes:
    sailmysql:
        driver: local
    sailmysql-files: # 新增这行
        driver: local
    # 其他原有卷配置保持不变
  

• 步骤3：配置本地文件权限，保证容器内可以读取自定义配置：
  执行命令：chmod 644 ./docker/8.0/my.cnf
• 步骤4：重启服务生效：
  执行命令：sail down && sail up -d
  注意：如果重启后还是报错，可以添加-v参数删除旧卷后重启，即执行sail down -v && sail up -d，该操作会清空现有MySQL数据，操作前请务必备份数据库内容

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