Laradock+MariaDB环境下spatie/laravel-backup报COLUMN_STATISTICS错误如何解决

Unknown table 'COLUMN_STATISTICS' 错误由MySQL 8.x版本的mysqldump客户端与MariaDB服务端的兼容性问题导致：MySQL 8.0+的mysqldump默认开启column-statistics参数统计列维度信息，但MariaDB不存在对应的COLUMN_STATISTICS系统表，因此导出备份时抛出错误。
之前修改my.cnf未生效，通常是Laradock环境下mysqldump未读取到正确路径的配置文件，或者配置段覆盖不全导致。

方案1：修改Laradock MariaDB配置并重建容器（推荐） #

该方案可以从全局解决所有调用mysqldump的兼容性问题：

• 进入Laradock根目录下的mariadb文件夹，打开my.cnf文件，若文件不存在则手动新建
• 在原有配置基础上新增两段配置，确保客户端和mysqldump都能读到参数：

[client]
column-statistics=0

[mysqldump]
column-statistics=0

• 回到Laradock根目录，重建MariaDB容器使配置生效：

docker-compose build --no-cache mariadb
docker-compose up -d mariadb

重建操作不会丢失已存储的数据库数据，Laradock默认将数据库数据持久化存储在独立卷中

方案2：直接配置spatie/laravel-backup导出参数 #

如果不想修改容器配置，可以直接在Laravel项目层修复：

• 打开项目目录下的config/database.php文件，找到connections.mysql.dump配置段，添加额外导出参数：

'mysql' => [
    // 保留原有其他配置项
    'dump' => [
        'add_extra_option' => '--column-statistics=0',
    ],
],

• 配置保存后无需重启容器，直接重新运行备份命令即可生效。

方案3：替换容器内的MySQL客户端 #

如果前两个方案均不生效，可以将运行备份的容器（workspace或php-fpm）内的MySQL客户端替换为MariaDB客户端，彻底解决兼容性问题：

• 进入对应容器（以workspace为例）：

docker-compose exec workspace bash

• 执行命令替换客户端：

apt update && apt remove -y mysql-client && apt install -y mariadb-client

• 执行mysqldump --version确认版本为MariaDB分支后，即可正常运行备份。

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