Linux btrfs 怎样查看子卷快照占用空间

要按子卷和快照查看 Linux btrfs 的空间，不能只看目录大小或把多个快照的文件大小相加。更稳妥的办法是先确认快照对应的子卷 ID，再使用 qgroup 统计读取 rfer（referenced，能从该 qgroup 访问到的空间）和 excl（exclusive，只由该 qgroup 独占的空间）。

官方文档：https://btrfs.readthedocs.io/en/latest/btrfs-qgroup.html

最常用的查看命令是 sudo btrfs qgroup show --human-readable --sync /mnt/data。其中 rfer 可能包含和源子卷共享的 extents，excl 更接近删除该子卷后可以释放的独占部分，但它不是普通目录大小。

先确认挂载点和快照的子卷 ID

qgroup 统计以 Btrfs 文件系统和子卷为对象，因此第一步不是执行 du，而是确定一个真正的 Btrfs 挂载点。下面的命令只读取挂载信息和子卷元数据，不会删除或修改快照。

# 找到 Btrfs 文件系统的挂载目标和设备来源
findmnt -t btrfs -o TARGET,SOURCE,FSTYPE,OPTIONS

# 列出挂载点下的子卷，并保留输出中的 ID 与路径
sudo btrfs subvolume list /mnt/data

# 查看某个快照的详细信息，重点记录 Subvolume ID
sudo btrfs subvolume show /mnt/data/.snapshots/snap-2026-11-08

假设快照的 ID 是 257，它对应的基础 qgroup 通常写成 0/257。Btrfs 文档说明，0 级 qgroup 会随子卷或快照创建，ID 与 subvolume ID 对应；不要把目录名当成稳定标识，因为快照目录可以改名。

确认 qgroup 已启用并让统计完成同步

如果系统还没有启用 subvolume quota，btrfs qgroup show 无法给出可用的子卷级空间统计。先查看当前状态：

# 查看挂载点上的 qgroup 状态
sudo btrfs quota status /mnt/data

# 只有在确认需要子卷级空间统计时才启用 qgroup
sudo btrfs quota enable /mnt/data

qgroup 会跟踪 extent 的引用关系，启用后可能增加写入、快照创建和删除时的维护成本。生产环境不要为了偶尔看一次数字就盲目开启；如果已经有快照管理或容量限制需求，再把它作为长期运维能力管理。

启用、创建快照或调整 qgroup 关系后，可以在读取时加上 --sync，让查询等待文件系统同步到当前状态。

用 qgroup show 读取每个快照的空间列

最小查询如下。--human-readable 使用易读的容量单位，--sync 则要求先同步相关状态。

# 查看该 Btrfs 文件系统中的 qgroup、引用空间和独占空间
sudo btrfs qgroup show --human-readable --sync /mnt/data

# 按独占空间从大到小排列，优先找出真正占用较多的新数据
sudo btrfs qgroup show --human-readable --sync --sort=-excl /mnt/data

# 需要脚本精确计算时输出不带单位后缀的字节数
sudo btrfs qgroup show --raw --sync /mnt/data

常见列可以这样读：

怎样解释 rfer 与 excl 的差异

快照最容易误读的地方是：创建快照不会立刻复制一份完整文件。源子卷和快照可以共同引用同一批 extents；只有快照修改或新写入的部分，才逐渐形成它自己的独占 extents。

因此，rfer 更像“从这个子卷或快照可以触达的总数据范围”，而 excl 是“所有相关引用都从该 qgroup 内消失时，才会随之释放的部分”。如果把源子卷和多个快照的 rfer 相加，结果会重复计算共享数据。

一个实用的判断方式是：

• rfer 很大而 excl 很小：快照主要仍与其他子卷共享旧数据。
• excl 随时间增长：快照中出现了较多新写入或对原有文件的 COW 修改。
• 删除快照后空间没有马上回收：删除操作先移除目录，后台还可能需要清理共享块；可以用 btrfs subvolume sync 等待删除完成。

统计不一致时如何处理

快照频繁创建、删除，或者 qgroup 层级关系发生变化时，统计可能暂时不一致。先不要把一次查询结果当成磁盘已经泄漏；先触发 quota rescan，再重新读取：

# 重新扫描 extent 共享关系，修正 qgroup 的引用与独占统计
sudo btrfs quota rescan -w /mnt/data

# 等待文件系统同步后再次读取快照的空间字段
sudo btrfs qgroup show --human-readable --sync /mnt/data

# 子卷删除是异步清理时，用 sync 等待当前删除队列完成
sudo btrfs subvolume sync /mnt/data

rescan 可能需要较长时间，并会增加文件系统工作量。不要把它放进高频监控脚本；更适合在明确发现统计不一致、完成批量快照整理或调整 qgroup 关系后执行一次。

从目录大小切换到快照级统计时的清单

如果原来只用 df 或 du 看空间，可以按下面的顺序迁移：

1. 用 findmnt -t btrfs 确定文件系统挂载点，而不是把普通目录当成 qgroup 查询路径。
2. 用 btrfs subvolume list 或 subvolume show 保存快照的稳定 ID。
3. 确认是否真的需要 qgroup；启用后把额外维护成本纳入快照策略。
4. 优先观察 excl 判断独占增长，用 rfer 了解快照可访问的数据范围。
5. 删除后等待后台清理，必要时再做一次 rescan，不要用多个目录的大小相加代替 qgroup 语义。

一句话总结：Btrfs 快照空间要看 extent 是否共享，qgroup show 的 rfer 和 excl 比目录大小更接近这个问题的真实结构。

相关问题

Btrfs 快照的 rfer 能直接当成磁盘新增占用吗？

不能。rfer 可能包含源子卷和其他快照已经引用的共享 extents，直接把多个 rfer 相加会重复统计。

为什么删除快照后 df 没有马上下降？

子卷目录删除和数据块清理是两个阶段，后台清理可能仍在处理共享块；先等待 subvolume sync，再结合 qgroup 和文件系统总量判断。

qgroup show 没有看到想要的快照怎么办？

先用 subvolume show 确认它确实是 Btrfs 子卷，再检查 quota 是否启用；如果刚创建或修改过快照，读取时加 --sync，必要时执行 quota rescan。