HDF5库分配内存释放失败：Windows Debug模式报错排查

我用Visual Studio 2019 C编译器、HDF5 1.12库编写程序，从H5文件加载动态字符串数组，使用后释放内存时出现错误——仅Windows Debug模式下失败，Release模式可正常运行。

原代码 #

{
    unsigned mode        = H5F_ACC_RDONLY;
    char     file_name[] = "d1.h5";

    // 假设已知数据集名称和大小
    char dset_name[] = "/group_name/daset_name";
    char**  elts = calloc(10, sizeof(char*));

    // 注意：此处多了一个右括号，是语法错误
    hid_t file = H5Fopen(file_name, mode, H5P_DEFAULT));
    hid_t dset = H5Dopen2(file, dset_name, H5P_DEFAULT);
    hid_t h5_type = H5Tcopy(H5T_C_S1);
    herr_t ret = H5Tset_size(h5_type, H5T_VARIABLE);


    // 读取所有数据集元素
    H5Dread(dset, h5_type, H5S_ALL, H5S_ALL, H5P_DEFAULT, elts);

    // 注意：此处错误关闭了dset，应该关闭h5_type
    H5Tclose(dset);
    H5Dclose(dset);
    H5Fclose(file);

    // elts中的内容示例：
    //    "asdf"
    //    "asdff"
    //    "asdfwer"
    //    "asdfffasdf"
    //    "asd"
    //    "asdf"
    //    "asdff"
    //    "asdfwer"
    //    "asdfffasdf"
    //    "asd"


    // 使用数据集元素进行操作


    // 释放内存时出错
    for(size_t i = 0; i < 10; i++) {
        free(elts[i]); // 该行触发错误
    }
    free(elts); // 该行无错误

}

错误信息 #

minkernel\crts\ucrt\src\appcrt\heap\debug_heap.cpp(908): Assertion failed: is_block_type_valid(header->_block_use)
unknown file: error: SEH exception with code 0xc0000005 thrown in the test body

问题分析与解决方案 #

1. 代码中的明显语法/资源管理错误 #

• H5Fopen调用多了一个右括号，会导致编译错误，需修正为：

  hid_t file = H5Fopen(file_name, mode, H5P_DEFAULT);
  

• H5Tclose(dset)是错误的，应该关闭的是之前创建的h5_type句柄，否则会造成资源泄漏：

  H5Tclose(h5_type);
  

2. 内存释放方式错误（核心问题） #

Windows Debug模式下，CRT调试堆会严格校验内存分配与释放的匹配关系。HDF5在分配可变长度字符串的内存时，使用的是自身的内存分配机制（或与Debug版CRT分配器不兼容），直接用free释放HDF5分配的内存会触发调试堆的断言错误。

正确的做法是使用HDF5提供的H5Dvlen_reclaim函数回收可变长度数据的内存，而非直接调用free。

修正后的完整代码 #

{
    unsigned mode        = H5F_ACC_RDONLY;
    char     file_name[] = "d1.h5";
    char dset_name[] = "/group_name/daset_name";
    char**  elts = calloc(10, sizeof(char*));

    // 修正括号错误
    hid_t file = H5Fopen(file_name, mode, H5P_DEFAULT);
    hid_t dset = H5Dopen2(file, dset_name, H5P_DEFAULT);
    hid_t h5_type = H5Tcopy(H5T_C_S1);
    herr_t ret = H5Tset_size(h5_type, H5T_VARIABLE);

    H5Dread(dset, h5_type, H5S_ALL, H5S_ALL, H5P_DEFAULT, elts);

    // 修正句柄关闭顺序和对象
    H5Dclose(dset);
    H5Tclose(h5_type);
    H5Fclose(file);

    // 使用数据集元素进行操作

    // 正确释放内存：先调用HDF5的回收函数，再释放elts本身
    H5Dvlen_reclaim(h5_type, H5S_ALL, H5P_DEFAULT, elts);
    free(elts);
}

为什么Debug模式报错而Release模式正常？ #

Debug模式下CRT会对内存块添加额外的校验信息，记录内存分配的来源和类型，当尝试用错误的方式释放内存时，会立即触发断言抛出错误；而Release模式下没有这些校验逻辑，错误会被暂时掩盖，但实际上存在内存泄漏或潜在的崩溃风险。

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