看起来你遇到的问题主要和HDF5文件的写入完整性、操作系统缓存以及程序中断时的资源清理有关，咱们一步步来拆解和解决：

一、运行时读取出现BlockingIOError的原因与解决 #

虽然你在代码里调用了H5Fclose关闭文件，但HDF5库和操作系统可能会把数据暂存在内存缓存中，没有立刻刷写到磁盘。这时候h5py尝试打开文件时，可能遇到文件还处于“未完全写入”的状态，或者操作系统还持有文件锁，导致无法读取。

解决方法是在关闭文件前强制刷写所有缓存，确保数据完全落地：
在H5Fclose(hdf5_fp);之前添加以下代码：

herr_t flush_err = H5Fflush(hdf5_fp, H5F_SCOPE_GLOBAL);
if (flush_err < 0) {
    fprintf(stderr, "Failed to flush HDF5 file %s\n", filename);
    // 可根据需求添加自定义错误处理逻辑
}

H5F_SCOPE_GLOBAL会把该文件下所有对象（数据集、组等）的缓存都刷到磁盘，确保文件状态完整，h5py就能正常打开了。

二、程序中断后文件损坏的原因与解决 #

当你中途终止程序时，程序可能正处于output_data函数的执行过程中，还没执行到H5Fflush或H5Fclose，导致文件只写入了一部分，HDF5的对象头结构不完整，所以h5py会报错“bad object header version number”。

解决这个问题需要注册信号处理函数，让程序在收到中断信号（比如Ctrl+C触发的SIGINT）时，优雅地关闭所有打开的HDF5资源：

#include <signal.h>

// 全局变量保存当前打开的HDF5文件句柄（多文件场景可改用数组/结构体管理）
hid_t global_hdf5_fp = -1;

void sigint_handler(int signum) {
    if (global_hdf5_fp != -1) {
        H5Fflush(global_hdf5_fp, H5F_SCOPE_GLOBAL);
        H5Fclose(global_hdf5_fp);
        global_hdf5_fp = -1;
        printf("Gracefully closed HDF5 file on interrupt\n");
    }
    exit(EXIT_SUCCESS);
}

// 在main函数开头注册信号处理逻辑
int main() {
    signal(SIGINT, sigint_handler);
    // ... 你的其他初始化代码
}

注意：如果output_data会被多次调用生成不同文件，需要调整全局变量的管理方式，确保每次打开文件时更新句柄，关闭时重置。

三、额外的检查与优化点 #

• 版本兼容性检查：确保你的C程序链接的HDF5库版本和h5py依赖的HDF5版本一致。版本不匹配可能导致各种读取问题，可以用h5dump -V查看C端版本，用h5py.version.info()查看Python端版本。
• 添加错误处理：你的代码没有检查HDF5函数的返回值（比如H5Fcreate、H5Gcreate2等都可能返回负数表示失败），如果某个步骤出错，后续的close操作可能无法正确执行，导致资源泄漏或文件损坏。建议给关键HDF5操作添加错误检查，比如：

  hid_t hdf5_fp = H5Fcreate(filename, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT);
  if (hdf5_fp < 0) {
      fprintf(stderr, "Failed to create HDF5 file %s\n", filename);
      return;
  }
  

备注：内容来源于stack exchange，提问作者Daan