C语言递归目录获取器内存释放空指针异常问题求助

常见问题点与排查步骤 #

• 字符串拼接时的内存操作错误
  递归遍历路径拼接时，容易出现重复释放已free的指针、或给未分配内存的指针调用free的情况。比如深层递归返回后，上层函数的路径指针被意外置为NULL，或是拼接时未正确分配内存就直接操作。
  检查点：每次拼接路径前，确认malloc/calloc的返回值有效；递归返回时，确保只释放当前层级分配的路径内存，不干扰上层指针的状态。

• 递归返回时的指针状态混乱
  若递归函数复用同一个指针变量，深层递归修改指针值后，上层函数的指针指向会被破坏。比如上层路径指针进入深层后被重新赋值，返回时该指针已指向被free的内存或NULL，此时调用free就会触发错误。
  检查点：递归传递路径参数时，传递当前层级的独立内存副本，而非共享同一指针。每次进入子目录前单独分配新路径内存，递归结束后立即释放该副本。

• dirent结构体的误用
  readdir返回的dirent结构体是库内部缓冲区，并非动态分配，不能直接调用free。若代码中错误free了该指针，也会引发内存错误。

修复示例代码 #

以下是修正后的递归遍历模板，解决内存分配与释放的核心问题：

#include <stdio.h>
#include <dirent.h>
#include <string.h>
#include <stdlib.h>

void traverse_dir(const char *base_path) {
    DIR *dir = opendir(base_path);
    if (!dir) {
        perror("opendir failed");
        return;
    }

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        // 跳过当前目录与上级目录
        if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0) {
            continue;
        }

        // 计算新路径长度并分配内存
        size_t path_len = strlen(base_path) + strlen(entry->d_name) + 2; // +2 用于路径分隔符和结束符
        char *new_path = malloc(path_len);
        if (!new_path) {
            perror("malloc failed");
            closedir(dir);
            return;
        }

        // 安全拼接路径
        snprintf(new_path, path_len, "%s/%s", base_path, entry->d_name);

        // 判断文件类型，递归遍历子目录或打印文件路径
        if (entry->d_type == DT_DIR) {
            traverse_dir(new_path);
        } else {
            printf("文件: %s\n", new_path);
        }

        // 释放当前层级的路径内存，不影响上层指针
        free(new_path);
    }

    closedir(dir);
}

int main() {
    traverse_dir(".");
    return 0;
}

关键注意事项 #

• 每次递归前分配独立的new_path，递归完成后立即释放，避免指针共享导致的状态混乱。
• 使用snprintf替代strcat，既可以避免缓冲区溢出，也能保证路径拼接的正确性。
• 必须检查所有内存分配的返回值，防止对NULL指针进行操作。
• 禁止freereaddir返回的entry指针，该结构体由系统库管理内存。

内容的提问来源于stack exchange，提问作者Elia Riva