Docker Compose中MariaDB卷偶发数据丢失（表结构保留）问题求助

我之前在开发环境用轻量MariaDB镜像时也碰到过类似的数据丢失情况，结合你的场景，从几个实际方向给你分析和解决思路：

一、先排查MariaDB核心持久化配置 #

这种表结构保留但数据丢失的情况，大概率是事务日志没有及时刷盘，导致异常退出后未提交的数据丢失。你可以先检查镜像的默认配置：

1. 进入容器查看当前的my.cnf配置：

   docker exec -it <你的容器名或ID> cat /etc/my.cnf
   

   （如果这个路径不对，试试/etc/mysql/my.cnf或者/var/lib/mysql/my.cnf，Alpine系统的配置路径可能因镜像而异）

2. 确保以下关键参数的配置符合持久化要求：

   • innodb_flush_log_at_trx_commit = 1：这是InnoDB保证ACID的关键参数，设置为1时，每次事务提交都会把日志刷到磁盘，避免缓存中的数据丢失。有些轻量镜像为了性能会把它改成2或0，牺牲数据安全换速度。
   • sync_binlog = 1：每次binlog写入后立即刷盘，防止二进制日志丢失，这对数据恢复很重要。
   • innodb_doublewrite = 1：开启双写缓冲，防止InnoDB页面部分写入导致的损坏。

3. 如果默认配置不符合要求，你可以自定义my.cnf并挂载到容器中，修改docker-compose的volumes部分：

   volumes:
     - ./custom-my.cnf:/etc/my.cnf
     - mariadb:/var/lib/mysql
   

   把上面的关键参数写到custom-my.cnf里覆盖默认配置。

二、确保容器正常关闭，避免强制终止 #

Docker的restart: always虽然方便，但如果容器被强制终止（比如docker kill、主机突然断电），MariaDB没有机会把内存中的缓存数据刷到磁盘，就会导致数据丢失：

• 停止容器时一定要用docker stop，而不是docker kill，docker stop会给MariaDB发送SIGTERM信号，让它执行正常关闭流程，刷写所有缓存。
• 在docker-compose中添加stop_grace_period: 30s，给MariaDB足够的时间完成关闭操作：

  db:
    image: yobasystems/alpine-mariadb
    restart: always
    stop_grace_period: 30s
    # 其他配置...
  

三、排查Docker卷的文件系统一致性问题 #

Docker卷本身是持久化的，但如果底层文件系统有写缓存未及时同步，或者卷的挂载方式有问题，也可能导致数据丢失：

1. 查看Docker卷的详细信息：

   docker volume inspect mariadb
   

   找到Mountpoint对应的主机路径，检查该路径所在的磁盘是否开启了写缓存，或者是否有磁盘IO异常。

2. 可以尝试临时换成主机绑定挂载（bind mount）代替Docker卷，看看问题是否复现：

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

   如果切换后数据不再丢失，说明可能是Docker卷的底层文件系统有问题。

四、查看MariaDB错误日志，定位具体原因 #

所有异常都会记录在错误日志里，这是排查问题的关键：

1. 进入容器查看错误日志：

   docker exec -it <容器名> tail -n 100 /var/log/mysql/error.log
   

   如果这个路径不对，试试/var/lib/mysql/<容器主机名>.err，通常在数据目录下。

2. 查找类似以下的关键词：

   • InnoDB: Database was not shut down normally!：说明容器是异常退出的，需要检查关闭流程。
   • Rolling back trx：有事务被回滚，可能是未提交的数据丢失。
   • Disk full：磁盘空间不足导致无法写入数据。

五、考虑更换为官方MariaDB Alpine镜像 #

yobasystems/alpine-mariadb是第三方维护的镜像，可能存在配置优化过度或维护不及时的问题。官方的mariadb:alpine镜像更可靠，配置更标准，你可以尝试替换镜像，看问题是否消失：

db:
  image: mariadb:alpine
  restart: always
  environment:
    - MARIADB_ROOT_PASSWORD=password
    - MARIADB_DATABASE=database
    - MARIADB_USER=user
    - MARIADB_PASSWORD=password
  # 其他配置不变...

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