Btrfs动态扩容必须执行btrfs device add和btrfs filesystem balance两步：add仅将设备注册进系统但不分配数据，balance才触发数据重分布、启用RAID冗余与条带化，否则新磁盘为空闲状态，容量不生效、profile不启用。
直接加磁盘就能用，但必须走 btrfs device add + btrfs filesystem balance 两步，跳过 balance 就等于白加——新磁盘不会存数据，RAID 也不会重分布。
为什么不能只用 btrfs device add
加磁盘只是把设备注册进文件系统，它处于“空闲待命”状态：btrfs filesystem show 能看到设备已列在设备列表里，但 btrfs filesystem usage /mount_point 显示它的已用空间仍是 0；所有读写仍只落在原有设备上。RAID1/RAID10 的冗余、条带化逻辑，只有 balance 后才真正启用。
- 常见错误现象：加完磁盘后
df -h容量没变，btrfs filesystem usage显示新设备data: total=0B, used=0B - balance 不是可选优化项，而是强制生效步骤；不执行，就只是“挂了个空壳”
- 如果目标是 RAID10，add 时无需指定 profile，profile 是 balance 阶段才应用的
btrfs device add 的实际操作要点
确保目标设备未被格式化、未挂载、未被 LVM 或 mdadm 占用（否则会报 Device is busy 或 Invalid argument）。
- 先确认设备名：用
lsblk或sudo fdisk -l找到裸设备，如/dev/sdc（不是/dev/sdc1） - 执行添加：
sudo btrfs device add /dev/sdc /mount_point（/mount_point必须是已挂载的 Btrfs 文件系统根路径） - 验证是否成功：
sudo btrfs filesystem show /mount_point应列出新设备；sudo btrfs device stats /mount_point此时可能报错（因未写入），属正常 - 不要对新设备单独 mkfs.btrfs，Btrfs 会自行管理底层块布局
balance 阶段怎么选参数才不翻车
默认 btrfs filesystem balance /mount_point 会重分布所有块类型（data/meta/system），但生产环境建议显式控制范围和 profile，避免无谓 IO 和长时间阻塞。
- 想升级 RAID 级别（如从 Single 到 RAID10）：用
sudo btrfs filesystem balance start -dconvert=raid10 -mconvert=raid10 /mount_point - 只想把新增空间利用起来（保持原 profile）：用
sudo btrfs filesystem balance start -dusage=5 -musage=5 /mount_point（仅迁移使用率低于 5% 的 chunk，快速腾出旧设备空间） - balance 过程中可中断：
sudo btrfs filesystem balance pause /mount_point；恢复用resume - 监控进度：
sudo btrfs filesystem balance status /mount_point；别靠df判断，它更新有延迟
扩容后必须检查的三件事
balance 完成不等于万事大吉。Btrfs 多设备卷的隐性风险集中在设备状态、写入策略和空间统计一致性上。
- 运行
sudo btrfs device stats /mount_point查看是否有write_errors或read_errors—— 新磁盘若存在坏道或连接不稳，这里最先暴露 - 确认 profile 生效：
sudo btrfs filesystem usage /mount_point中各设备的data和metadata使用量应趋于均衡（RAID10 下单设备用量 ≈ 总用量 / 设备数） - 检查挂载选项：如果用了
autodefrag或space_cache=v2，balance 后无需重挂载，但若曾手动禁用enospc_debug，建议临时开启一次观察日志
最易被忽略的是设备健康反馈——btrfs device stats 输出为 0 不代表没问题，得看有没有非零错误计数；而 balance 本身不校验磁盘物理层，加盘前用 smartctl -a /dev/sdc 快扫一遍更稳妥。
