HDF5库：可运行现有二进制但编译失败，原因何在？

问题根因 #

运行时能通过软链兼容是因为HDF5 1.10.x的共享库对1.8.x的二进制有一定向后兼容性，但编译链接阶段会严格检查符号的版本标识（比如@HDF5_CPP_1.8.15）。系统自带的HDF5 1.10.7的C++库符号版本是HDF5_CPP_1.10.x，和编译需要的HDF5_CPP_1.8.15不匹配，所以即使指定了软链后的库文件，链接器依然会报错。

具体解决步骤 #

• 强制指定编译依赖为HDF5 1.8.x版本
  编译时必须链接你手动编译的HDF5 1.8.15/1.8.16库，而不是系统的1.10.7：

  1. 在编译命令中添加头文件路径：-I/path/to/hdf5-1.8.15/include
  2. 添加库路径：-L/path/to/hdf5-1.8.15/lib
  3. 明确链接C库：-lhdf5_cpp -lhdf5_serial（注意顺序，C库要放在前面）
     示例编译命令：

  g++-5 -I/usr/local/hdf5-1.8.15/include -L/usr/local/hdf5-1.8.15/lib your_source.cpp -o your_binary -lhdf5_cpp -lhdf5_serial
  

• 验证库的符号版本
  用nm命令检查1.8.x的C++库是否包含目标符号：

  nm -D /usr/local/hdf5-1.8.15/lib/libhdf5_cpp.so | grep "H5::CommonFG::openDataSet"
  

  输出应该包含@HDF5_CPP_1.8.15的标识，而系统1.10.7的库输出会是更高版本的标识。

• 清理Netbeans编译缓存
  删除项目的build目录，重新打开Netbeans并配置项目的编译器和依赖路径：

  1. 右键项目 -> 属性 -> 构建 -> C++编译器 -> 包含目录，添加HDF5 1.8.x的include路径
  2. 链接器 -> 库目录，添加HDF5 1.8.x的lib路径
  3. 链接器 -> 库，添加hdf5_cpp和hdf5_serial

• 确认编译器版本
  在Netbeans中指定编译器为g++-5：
  右键项目 -> 属性 -> 构建 -> 工具集合，选择g++-5作为默认编译器，避免用系统更高版本的g++导致ABI不兼容。

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