debian readdir为何漏读部分文件

在 Debian（以及一般 Linux）上，readdir() “漏读文件”通常不是 glibc 或内核 bug，而是使用方式或环境差异导致的。下面按常见原因从高到低说明。

1. 最常见原因：readdir() 返回的是相对名，不是绝对路径

很多“漏读”其实是路径拼错，导致后续 stat/open 失败，看起来像没读到。

DIR *d = opendir("/data/logs");
struct dirent *e;
while ((e = readdir(d))) {
    // 错误：用 e->d_name 直接打开
    // open(e->d_name, ...) // ❌ 当前目录不一定在 /data/logs
}

✅ 正确做法：

char path[1024];
snprintf(path, sizeof(path), "%s/%s", "/data/logs", e->d_name);

2. 文件系统是异步/网络/挂载型（NFS、FUSE、overlay）

在以下场景中，readdir() 可能：

• 返回不完整列表
• 多次调用结果不一致
• 受缓存影响

常见问题：

• NFS：服务器缓存、属性不一致
• Docker overlayfs：某些层文件不可见
• CIFS/SMB：权限映射问题

✅ 排查：

mount | grep 目录
df -T 目录

3. 目录中文件非常多（十万+）

readdir() 本身是可靠的，但：

• 遍历时间长
• 期间文件被创建/删除/重命名
• 导致“看似漏读”

✅ 建议：

• 使用 getdents64()（更底层）
• 或先 ls > list.txt 快照

4. 隐藏文件（. 开头）被你代码过滤掉了

readdir() 一定会返回：

.
..
.hidden

如果你写了：

if (e->d_name[0] == '.') continue;

就会“漏掉”隐藏文件。

5. 权限不足（部分子目录/文件不可见）

• 父目录有 x 权限但无 r
• 某些文件 stat 失败被跳过

✅ 检查：

ls -la 目录
namei -l 路径

6. 你用的是 readdir_r() 且 buffer 太小（已废弃）

旧代码常见错误：

readdir_r(dir, &entry, &result);

在多线程或长文件名下可能出错。

✅ 现代写法：

while ((e = readdir(dir)) != NULL)

7. 编码 / 文件名含特殊字符

• 非 UTF-8
• 含换行、空格、控制字符

导致：

• 日志看起来“丢了”
• 实际只是显示异常

8. 真的是 bug？极少情况

仅在以下情况可能存在：

• 自定义内核模块
• 损坏的文件系统（fsck 检查）
• 非常老的内核 + 特殊 FS

快速自检清单

✅ 是否拼了完整路径
✅ 是否过滤了 . 文件
✅ 是否网络/挂载文件系统
✅ 遍历时目录是否被修改
✅ 权限是否足够

如果你愿意，可以把：

• 你的 readdir() 代码
• mount 信息
• 文件数量和类型

贴出来，我可以直接帮你定位是哪一类问题。