修复孤立libhdf5系列库后出现Caffe编译错误，疑符号链接错误？

首先可以确定：你手动创建符号链接的操作确实可能引发了Caffe编译时的HDF5库关联问题，核心原因是Caffe没有正确匹配到HDF5 serial库的头文件和实现文件，导致H5Fis_hdf5函数无法被识别。

下面是分步排查和修复方案：

1. 验证当前符号链接的有效性 #

先确认你创建的链接是否指向正确文件，且目标库包含H5Fis_hdf5符号：

• 查看符号链接指向：

  ls -l /usr/lib/x86_64-linux-gnu/libhdf5.so /usr/lib/x86_64-linux-gnu/libhdf5_hl.so
  

  正常应该指向/usr/lib/x86_64-linux-gnu/hdf5/serial/下的对应版本文件（比如libhdf5.so.103这类带版本号的文件）。
• 检查目标库是否包含目标函数：

  nm -D /usr/lib/x86_64-linux-gnu/hdf5/serial/libhdf5.so | grep H5Fis_hdf5
  

  如果没有任何输出，说明你使用的HDF5 serial版本不包含这个函数（可能性较低，大概率是路径匹配问题）。

2. 修正Caffe的Makefile.config配置 #

系统中通常并存HDF5的serial和parallel版本，Caffe默认可能未指向serial版本路径，你需要手动指定：
打开Caffe根目录下的Makefile.config，确保以下配置项正确设置：

# 启用HDF5支持
USE_HDF5 := 1
# 指定serial版本的HDF5头文件路径
HDF5_INCLUDE_DIR := /usr/include/hdf5/serial
# 指定serial版本的HDF5库文件路径
HDF5_LIB_DIR := /usr/lib/x86_64-linux-gnu/hdf5/serial

保存后，若使用cmake构建的Caffe版本，可先执行cmake .重新生成Makefile。

3. 用系统工具管理符号链接（推荐） #

手动创建符号链接容易出现版本冲突，建议用update-alternatives统一管理：

# 注册serial版本的HDF5库到系统备选
sudo update-alternatives --install /usr/lib/x86_64-linux-gnu/libhdf5.so libhdf5.so /usr/lib/x86_64-linux-gnu/hdf5/serial/libhdf5.so 100
sudo update-alternatives --install /usr/lib/x86_64-linux-gnu/libhdf5_hl.so libhdf5_hl.so /usr/lib/x86_64-linux-gnu/hdf5/serial/libhdf5_hl.so 100

# 选择使用serial版本
sudo update-alternatives --config libhdf5.so
sudo update-alternatives --config libhdf5_hl.so

执行config命令后，选择对应serial版本的序号即可。

4. 清理并重新编译 #

完成上述配置后，清理之前的编译缓存并重新编译：

cd /path/to/caffe
make clean
make all -j$(nproc)

补充说明 #

H5Fis_hdf5是HDF5标准库中的函数，用于校验文件是否为合法的HDF5格式。编译时找不到的常见原因：

• 头文件路径错误：Caffe包含的是其他版本HDF5的头文件，而该头文件中未声明这个函数
• 库文件不匹配：链接的HDF5库版本和头文件版本不一致
• 未正确链接HDF5库：Makefile中缺少-lhdf5 -lhdf5_hl链接参数

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