linux xfs_repair命令

重要提示：xfs_repair命令用于修复损坏的XFS文件系统。在执行修复前，请务必卸载文件系统并备份重要数据。

语法格式

xfs_repair [选项] 设备文件

常用选项

选项	说明
-n	只检查而不进行修复操作（试运行）
-L	强制清空日志（谨慎使用，可能导致数据丢失）
-f	强制修复，即使文件系统看起来是干净的
-v	详细模式，显示更多信息
-d	修复只读挂载的文件系统（需要设备空闲）
-m	在修复前执行元数据扫描
-c	设置子操作选项，如`subopt=value`
-t	设置修复操作的超时时间（秒）

使用示例

示例1：检查XFS文件系统但不修复

# 首先卸载文件系统
sudo umount /dev/sdb1

# 检查文件系统状态（不执行修复）
sudo xfs_repair -n /dev/sdb1

说明：使用-n选项可以安全地检查文件系统状态，不会进行任何修改。

示例2：修复XFS文件系统

# 卸载文件系统
sudo umount /dev/sdb1

# 修复文件系统
sudo xfs_repair /dev/sdb1

# 修复完成后重新挂载
sudo mount /dev/sdb1 /mnt/data

示例3：强制清空日志并修复

# 在日志损坏无法恢复时使用
sudo umount /dev/sdb1
sudo xfs_repair -L /dev/sdb1

警告：-L选项会强制清空日志，可能导致数据丢失。仅在确定日志损坏且其他方法无效时使用。

示例4：详细模式修复

# 使用详细模式查看修复过程
sudo xfs_repair -v /dev/sdb1

示例5：修复过程中的交互式操作

# 修复过程中可能需要回答一些问题
sudo xfs_repair /dev/sdb1

# 典型输出和交互
Phase 1 - find and verify superblock...
Phase 2 - using internal log
        - zero log...
        - scan filesystem freespace and inode maps...
        - found root inode chunk
Phase 3 - for each AG...
        - scan and clear agi unlinked lists...
        - process known inodes and perform inode discovery...
        - agno = 0
        - agno = 1
        - agno = 2
        - agno = 3
        - process newly discovered inodes...
Phase 4 - check for duplicate blocks...
        - setting up duplicate extent list...
        - check for inodes claiming duplicate blocks...
        - agno = 0
        - agno = 1
        - agno = 2
        - agno = 3
Phase 5 - rebuild AG headers and trees...
        - reset superblock...
Phase 6 - check inode connectivity...
        - resetting contents of realtime bitmap and summary inodes
        - traversing filesystem ...
        - traversal finished ...
        - moving disconnected inodes to lost+found ...
Phase 7 - verify and correct link counts...
done

常见修复场景

场景1：系统崩溃后的修复

检查系统日志确认崩溃原因：dmesg | grep -i xfs
卸载文件系统：sudo umount /dev/sdX1
运行检查：sudo xfs_repair -n /dev/sdX1
根据检查结果决定是否执行修复：sudo xfs_repair /dev/sdX1

场景2：文件系统无法挂载

尝试挂载并查看错误信息：sudo mount /dev/sdX1 /mnt
如果提示"mount: wrong fs type, bad option, bad superblock"，运行：sudo xfs_repair /dev/sdX1
如果修复失败，尝试强制修复：sudo xfs_repair -f /dev/sdX1
重新挂载：sudo mount /dev/sdX1 /mnt

修复前的必要步骤

在进行xfs_repair之前必须执行的操作：

备份数据：如果可能，先备份文件系统中的重要数据
卸载文件系统：确保文件系统没有挂载：sudo umount /dev/sdX1
检查挂载状态：确认卸载成功：mount | grep /dev/sdX1
检查文件系统类型：确保是XFS文件系统：sudo blkid /dev/sdX1

Q: 如果xfs_repair失败怎么办？

A: 可以尝试以下步骤：

使用xfs_check获取更详细的错误信息
尝试使用-L选项清空日志（注意数据丢失风险）
考虑使用xfsdump和xfsrestore备份并恢复数据
在极端情况下，可能需要重新格式化文件系统

Q: 如何检查文件系统是否需要修复？

A: 运行xfs_repair -n进行只检查，或者使用xfs_check命令。

上一章: xfs_info 命令下一章: debugfs 命令

Linux命令手册