怎样调试Debian readdir问题

在 Debian 上调试 readdir 相关问题（目录读取异常、返回错误、挂起、缺文件等），可以按下面思路系统性排查。

一、先明确“readdir 问题”是哪一层

readdir 有多种形态，先分清：

常见问题包括：

• readdir 返回 NULL 但 errno 不明确
• 目录内容不完整
• readdir 卡住不返回
• NFS / overlay 下行为异常

二、基本用户态排查（最常见）

1️⃣ 用 ls / strace 复现

ls -la problem_dir
strace ls problem_dir

关注：

• getdents*
• 返回 EIO, ENOENT, ESTALE
• 卡在哪个系统调用

2️⃣ 写最小 C 测试程序

#include <dirent.h>
#include <stdio.h>
#include <errno.h>

int main() {
    DIR *dir = opendir(".");
    if (!dir) {
        perror("opendir");
        return 1;
    }

    struct dirent *entry;
    errno = 0;
    while ((entry = readdir(dir)) != NULL) {
        printf("%s\n", entry->d_name);
    }
    if (errno != 0) {
        perror("readdir");
    }
    closedir(dir);
    return 0;
}

说明：

• readdir() 返回 NULL 时，必须检查 errno
• errno == 0 → 正常结束
• errno != 0 → 出错

三、strace / ltrace 调试（非常重要）

1️⃣ 跟踪系统调用

strace ./readdir_test

重点看：

getdents(3, ....)

返回值：

• EIO → 文件系统错误
• ENOENT → 目录被删
• ESTALE → NFS 句柄失效
• 阻塞 → 内核/存储问题

四、内核 / 文件系统层排查

1️⃣ 查看内核日志

dmesg -T | tail -100
journalctl -k

常见错误：

• ext4_error
• I/O error
• NFS: server not responding

2️⃣ 检查文件系统

df -hT

如果是 ext4：

umount /mountpoint
fsck.ext4 -f /dev/sdX

如果是 NFS：

mount | grep nfs

五、NFS / Overlay / FUSE 特殊情况

NFS

问题：

• readdir 返回 ESTALE
• 目录不一致

处理：

mount -o remount,hard,intr,timeo=30

或：

• 升级 NFS 版本（nfsvers=3 或 4.2）
• 检查 nfsd / 服务端

OverlayFS

常见于 Docker / Podman：

mount | grep overlay

表现：

• 目录漏项
• readdir 顺序异常

解决：

• 升级内核
• 避免多层 overlay
• 用 ls 对比 upper / lower

六、工具辅助定位

1️⃣ 用 ltrace

ltrace ./readdir_test

查看：

• readdir() 返回值
• malloc 是否失败

2️⃣ 用 perf top / perf trace

perf trace ./readdir_test

查看系统调用延迟。

七、交叉验证（很重要）

• 换目录对比
• 换用户 (root / 普通用户)
• 换内核
• 换机器
• 换文件系统

八、常见问题速查表

九、如果你愿意进一步定位

可以直接贴出：

1. Debian 版本
2. 内核版本
3. 使用的 文件系统
4. 是否涉及 NFS / overlay / Docker
5. 最小复现代码或 strace 输出

我可以帮你精准定位是 用户态 bug、glibc、内核还是存储问题。