nfs-stale-file-handle

NFS Stale file handle 的定位与修复

现象

访问 NFS 挂载点报 Stale file handle、ESTALE，ls/stat/应用读取失败。常见于 NFS 服务端重启、导出变化或文件被移动。

快速定位

mount | grep nfs
showmount -e <nfs-server>
nfsstat -m
dmesg | tail -50
stat /mnt/nfs/path

服务端：

exportfs -v
systemctl status nfs-server
journalctl -u nfs-server --since '30 min ago'

常见根因

1. NFS 服务端重启或导出重新加载，旧文件句柄失效。
2. 导出目录被移除、重命名或权限变化。
3. 文件在服务端被删除/移动，客户端仍持有旧句柄。
4. 服务端 IP 变化、DNS/网络切换或防火墙中断。
5. 客户端缓存了旧挂载信息，NFS 版本不匹配。

修复

• 先确认服务端在线、导出存在且客户端有权限。
• 重新挂载通常能清除 stale handle；先尝试普通 umount，必要时 umount -f。
• 不要在有写入的挂载点上强制卸载；先停业务。
• 恢复被误删/移动的导出路径，或更新客户端挂载源。
• 检查 NFS 版本、vers= 和挂载选项是否一致。
• 频繁出现要查网络稳定性和服务端重启原因。

相关命令

• mount / umount — 挂载管理
• showmount — 导出查看
• nfsstat — NFS 统计
• exportfs — 服务端导出