BTRFS 文件损坏排查与修复指南

FNOS 虚拟机启动后，登录界面持续输出 BTRFS 错误日志，corrupt 计数从 2450 持续增长到 2481，表明文件系统检测到了数据损坏。

登录系统后，执行以下命令查看完整的 BTRFS 错误信息：

sudo dmesg | grep -i btrfs

关键错误信息示例：

BTRFS warning (device dm-0): csum failed root 5 ino 26287227 off 11952128
  csum 0x4c4c8746 expected csum 0x20a86902 mirror 1
BTRFS error (device dm-0): bdev /dev/mapper/trim_50933956_...-0
  errs: wr 0, rd 0, flush 0, corrupt 2450, gen 0

查看系统硬盘配置：

查看各存储空间使用情况：

df -h /vol1 /vol2

# 启动 scrub
sudo btrfs scrub start /vol1

# 查看执行状态
sudo btrfs scrub status /vol1

sudo btrfs scrub start /vol2
sudo btrfs scrub status /vol2

实际执行结果（vol1）：

UUID:             163cbaa2-9373-4c8c-bde4-9a69b404f762
Scrub started:    Sat Mar 28 14:38:59 2026
Status:           finished
Duration:         0:32:25
Total to scrub:   228.24GiB
Rate:             120.17MiB/s
Error summary:    csum=1
  Corrected:      0
  Uncorrectable:  1
  Unverified:     0

从 dmesg 日志中获取 inode 编号（ino 26287227），然后查找对应文件：

sudo find / -inum 26287227

实际输出：

/vol1/docker/containers/960c13148dfe.../960c13148dfe...-json.log

该文件是 Docker 容器的日志文件，属于可再生数据，非关键业务文件。

# 查看损坏文件详情
ls -lh /vol1/docker/containers/960c13148dfe.../960c13148dfe...-json.log

# 查看是哪个容器的日志
docker ps -a --filter "id=960c13148dfe"

除 inode 定位外，建议对整个存储空间做一次完整性扫描，排查是否有其他损坏文件：

# 方法一：find 遍历并记录读取失败的文件
sudo find /vol1 -type f -exec cat {} >/dev/null 2>>/tmp/damaged_files.log \;

# 方法二：rsync 备份并记录错误（推荐，可同时完成备份）
rsync -avh --progress /vol1/ /vol2/backup/vol1/ 2>>/tmp/backup_errors.log

sudo btrfs scrub start /vol1

sudo btrfs scrub status /vol1

期望看到：

Error summary:    csum=0
  Corrected:      0
  Uncorrectable:  0
  Unverified:     0

dmesg | grep -i "btrfs error"

如果没有新的错误输出，说明问题已彻底解决。

FNOS Web 控制台中没有文件一致性校验的入口，需要手动添加 crontab：

# 一条命令添加：每月1号凌晨3点对 vol1 和 vol2 执行 scrub
(crontab -l 2>/dev/null; echo "0 3 1 * * /usr/sbin/btrfs scrub start /vol1 && /usr/sbin/btrfs scrub start /vol2") | crontab -

# 验证 crontab 是否添加成功
crontab -l

避免日志文件过大导致类似问题：

# 编辑 Docker 配置
sudo nano /etc/docker/daemon.json

添加以下内容：

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "50m",
    "max-file": "3"
  }
}

# 重启 Docker 服务
sudo systemctl restart docker

建议遵循 3-2-1 备份原则：