构建AWS Lambda Docker镜像时h5py依赖HDF5缺失问题求助

1. 显式指定HDF5路径给pip #

yum安装的HDF5库路径可能不在pip默认搜索范围内，安装时通过环境变量明确指定HDF5根目录：

HDF5_DIR=/usr pip3 install h5py

/usr是yum安装HDF5的默认路径，该环境变量会告诉h5py的安装脚本去哪里查找依赖库。

2. 更新动态链接缓存并验证库路径 #

安装完HDF5后，手动更新系统动态链接库缓存，确保系统能识别到libhdf5.so：

ldconfig

如果仍提示找不到，先定位库文件位置：

find /usr -name libhdf5.so

通常路径为/usr/lib64/libhdf5.so，若不在标准搜索路径，可临时添加到环境变量后再执行安装：

export LD_LIBRARY_PATH=/usr/lib64:$LD_LIBRARY_PATH
pip3 install h5py

3. 安装ARM64预编译轮子 #

跳过源码编译，直接安装适配ARM64架构的预编译h5py包，确保pip优先使用manylinux轮子：

pip3 install --only-binary=:all: h5py

Lambda的Python基础镜像基于Amazon Linux，原生支持manylinux标准的预编译包，能避免编译过程中的依赖问题。

4. 调整Dockerfile安装顺序 #

将系统依赖安装、动态链接缓存更新、pip升级和h5py安装步骤整合，保证依赖加载顺序正确，示例片段：

# 安装系统依赖并配置环境
RUN yum install -y hdf5-devel hdf5 gcc gcc-c++ && \
    ldconfig && \
    pip3 install --upgrade pip && \
    HDF5_DIR=/usr pip3 install h5py

5. 修复HDF5系统安装完整性 #

如果h5dump --version命令报错，说明HDF5本身安装不完整，可启用epel源重新安装：

yum install -y epel-release && \
    yum install -y hdf5-devel hdf5

6. 指定兼容的h5py版本 #

部分新版本h5py与系统安装的HDF5版本可能不兼容，可根据HDF5版本（h5dump --version查看）指定匹配的h5py版本，例如HDF5 1.10.x系列对应：

HDF5_DIR=/usr pip3 install h5py==3.10.0

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