debian readdir为何读取失败

在 Debian（以及一般 Linux）系统上，readdir() 读取目录失败通常不是函数本身的问题，而是权限、路径、文件描述符状态或并发问题导致的。下面按常见原因逐一说明，并给出排查方法。

一、最常见原因

1. 目录路径错误或不存在

传入 opendir() 的路径不存在
路径是一个文件而不是目录

示例错误：

DIR *dir = opendir("/some/path");
if (!dir) {
    perror("opendir");
}

排查：

ls -ld /some/path

2. 权限不足（非常常见）

即使目录存在，也可能没有读权限（r）或执行权限（x）。

ls -ld /some/path
# 示例
drwx------ 2 root root 4096 ...

程序以普通用户运行就会失败

解决：

用 sudo 运行
或修改权限：

chmod +rx /some/path

3. opendir 成功但 readdir 返回 NULL

readdir() 返回 NULL 有两种情况：

✅ 正常情况

❌ 错误情况

出错时 errno 会被设置

正确写法：

errno = 0;
struct dirent *entry = readdir(dir);
if (entry == NULL) {
    if (errno != 0) {
        perror("readdir");
    } else {
        // 正常结束
    }
}

4. 目录在遍历过程中被删除或修改

此时 readdir() 可能返回 ENOENT 或 EBADF

5. DIR 指针被关闭或重复使用

closedir(dir);
readdir(dir); // 未定义行为

6. 挂载问题（NFS / FUSE / 网络目录）

在 Debian 上常见：

NFS 挂载断开
FUSE 文件系统异常

现象：

opendir 成功
readdir 报错：EIO, ESTALE

排查：

mount | grep path
dmesg | tail

二、典型错误码（errno）

errno	含义
EACCES	权限不足
ENOENT	目录不存在
ENOTDIR	不是目录
EBADF	DIR 已关闭
EMFILE / ENFILE	文件描述符耗尽
EIO	I/O 错误（磁盘/网络）

三、一个完整健壮示例

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

int main() {
    DIR *dir = opendir("/var/log");
    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;
}

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

你可以贴出：

具体代码
perror / errno 输出
出问题的目录路径
Debian 版本（cat /etc/debian_version）

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