如何使用HDF5 C++库正确修改已存在对象的属性

• 核心API使用偏差：你调用的H5::H5File::openAttribute()方法，设计上仅用于打开文件根对象自身挂载的属性，不会自动解析路径定位子Group、子数据集下的属性。你传入的"/Data/version"参数，会被根文件对象识别为「根对象下名为"/Data/version"的属性」，而非「/Data路径下Group的version属性」，这就是报错提示“找不到属性”的直接原因。
• 你之前猜测的“关闭Group对象导致无法访问属性”并非问题根源：HDF5的结构是持久化存储在磁盘文件中的，关闭内存中的Group句柄不会删除磁盘上的元数据，只要重新打开对应的Group句柄，就能正常访问其下的所有结构。

遵循HDF5属性访问的标准流程：先定位挂载了目标属性的父对象（Group/数据集/文件根），再从父对象上打开对应名称的属性完成读写，不要直接给根对象的属性接口传带路径的全属性名。
适配你的业务场景的操作方式分两种：

1. 初始化完成后、同流程内修改属性：不需要特意关闭初始化阶段的Group句柄，直接通过Group对象打开已有的属性完成值覆盖即可，全程不需要额外的路径解析。
2. 初始化完成后已经关闭Group句柄、文件句柄仍保持打开：先通过文件对象重新打开目标路径的Group获取内存句柄，再从Group上打开对应属性完成修改，完全不影响已写入的原有结构。

替换原代码中错误的属性打开逻辑，完整可运行版本如下：

#include <iostream>
#include <cstdint>
#include <string>
#include "H5Cpp.h"

const H5std_string FILE_NAME( "test.h5" );

int main (void)
{
  /* 创建覆盖式写入的HDF5文件，若已存在则清空原有内容 */
  H5::H5File file(FILE_NAME, H5F_ACC_TRUNC);

  /* 初始化阶段：创建Group、定义属性结构并写入默认值 */
  H5::Group g_data(file.createGroup( "/Data" ));
  H5::DataSpace dspace = H5::DataSpace(H5S_SCALAR);
  H5::Attribute version = g_data.createAttribute("version", H5::PredType::NATIVE_INT, dspace);
  int curVersion = 1;
  version.write(H5::PredType::NATIVE_INT, &curVersion);
  
  /* 按资源管理规则释放句柄，不会删除磁盘上已写入的结构 */
  version.close();
  dspace.close();
  g_data.close();

  /* 后续修改阶段：哪怕之前关闭过Group，只要文件句柄保持打开，就能重新访问结构 */
  H5::Group g_data_exist = file.openGroup("/Data"); // 重新打开目标路径的Group
  // 从Group上直接打开其下名为version的属性，不需要拼接全路径
  H5::Attribute new_version = g_data_exist.openAttribute("version");
  int newVersion = 2;
  new_version.write(H5::PredType::NATIVE_INT, &newVersion);
  
  /* 按顺序释放所有资源 */
  new_version.close();
  g_data_exist.close();
  file.close();

  return 0;
}

• HDF5的属性在创建时就固定了数据类型、数据空间尺寸，修改属性值只是覆盖原有存储块的内容，不会改动属性的元数据结构，不需要删除重建属性。
• HDF5 1.10+的底层C API虽然提供了支持路径解析的全路径属性打开能力，但官方C++封装层的H5File::openAttribute并未实现该路径解析逻辑，不要混淆不同API的适用范围。
• 关闭内存中的HDF5对象句柄（Group/Attribute/Dataset）只是释放进程内的资源，不会修改磁盘上存储的文件结构，后续只要通过合法路径重新打开对应对象句柄，就能正常完成读写操作。

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