Debian readdir为何失效

Debian 下 readdir() 失效通常不是系统本身的问题，而是使用方式、目录状态或权限导致的。下面按最常见原因 → 排查方法 → 示例来说明。

一、readdir 是什么

readdir() 用于读取目录内容，常见于：

C / C++：opendir() + readdir()
Shell：ls 内部也依赖目录读取
脚本（通过绑定或系统调用）

二、常见失效原因（重点）

1️⃣ 目录未成功打开（最常见）

DIR *dir = opendir(path);
if (dir == NULL) {
    perror("opendir");
}

可能原因：

路径不存在
权限不足
不是目录（是文件）

✅ 排查：

ls -ld /path

2️⃣ 目录为空

readdir() 返回 NULL 并不代表失败：

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

返回 NULL 可能是正常结束
也可能真的是错误

✅ 判断方式：

errno = 0;
entry = readdir(dir);
if (entry == NULL && errno != 0) {
    perror("readdir");
}

3️⃣ 权限问题（Debian 很常见）

即使你能 cd 进目录，也可能无法 readdir：

ls -ld /some/dir

目录需要 r + x
用户 / 组 / other 权限检查

✅ 测试：

sudo -u www-data ls /path

4️⃣ 目录被删除或替换（TOCTOU）

目录在 opendir() 后被删除
或被 mount/overlay 替换

✅ 现象：

readdir: No such file or directory

5️⃣ 文件系统问题

NFS 目录
FUSE
损坏的文件系统

✅ 检查：

dmesg | tail
mount | grep path

6️⃣ 32/64 位或 _FILE_OFFSET_BITS 问题（老程序）

在 Debian amd64 上：

readdir() 实际是 readdir64()
老代码或交叉编译可能出问题

✅ 建议：

#define _GNU_SOURCE
#include <dirent.h>

7️⃣ 多线程 / 并发问题

同一 DIR* 被多个线程使用
未加锁

✅ 正确做法：

每个线程单独 opendir()

三、一个完整正确示例

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

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

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

    if (errno != 0) {
        perror("readdir");
    }

    closedir(dir);
    return 0;
}

四、快速自检清单 ✅

[ ] opendir() 返回值是否为 NULL
[ ] 是否检查 errno
[ ] 目录是否有 r+x 权限
[ ] 目录是否为空
[ ] 是否在多线程中使用同一 DIR*
[ ] 文件系统是否异常

五、如果你愿意，我可以进一步帮你

你可以贴出：

具体代码
错误信息
Debian 版本
目录类型（本地 / NFS / Docker / chroot）

我可以直接帮你定位是哪一条导致的 readdir 失效。