MacOS下Python3.11导入pygrib报错：_grib_context_set_definitions_path符号缺失

错误信息 #

ImportError: dlopen(/Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages/pygrib/_pygrib.cpython-311-darwin.so, 0x0002): symbol not found in flat namespace '_grib_context_set_definitions_path'

环境信息 #

• Python版本：3.11
• 操作系统：MacOS Ventura 13.5.1
• 安装方式：pip

复现步骤 #

1. 执行pip install pygrib安装库
2. 运行以下脚本：

import pygrib

grbs = pygrib.open('2m_temperature.grib')

for grb in grbs:
    print(grb)
    exit()

已尝试的操作 #

• 多次重新安装pygrib
• 确认当前环境为Python3.11，排查多环境冲突
• 在Python3.11虚拟环境内安装并测试
• 完全卸载后重新安装
• 尝试从源码编译（操作步骤存疑）
• 搜索同类问题未找到适配方案

解决思路与建议 #

1. 匹配ECMWF依赖库版本 #

这个错误本质是pygrib的C扩展找不到eccodes（原grib-api）库中的符号，说明依赖库版本不兼容或未正确安装：

• 卸载现有pygrib：pip uninstall -y pygrib
• 用Homebrew安装eccodes：brew install eccodes
• 重新安装pygrib并指定eccodes路径：

  pip install pygrib --global-option=build_ext --global-option="-I$(brew --prefix eccodes)/include" --global-option="-L$(brew --prefix eccodes)/lib"
  

2. 统一编译架构 #

MacOS Ventura下Python3.11可能存在arm64/x86_64架构不匹配问题：

• 检查当前Python架构：python3 -c "import platform; print(platform.machine())"
• 若为x86_64，需用对应架构安装依赖和库：

  arch -x86_64 brew install eccodes
  arch -x86_64 pip install pygrib
  

3. 正确的源码编译步骤 #

如果之前源码编译操作有误，按以下流程执行：

1. 拉取pygrib源码：git clone https://github.com/jswhit/pygrib.git
2. 进入源码目录：cd pygrib
3. 设置环境变量指向eccodes：

   export ECCODES_DIR=$(brew --prefix eccodes)
   

4. 编译并安装：

   python setup.py build_ext --inplace -I${ECCODES_DIR}/include -L${ECCODES_DIR}/lib
   pip install .
   

4. 验证依赖链接 #

安装完成后，检查pygrib的C扩展是否正确链接eccodes：

otool -L /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages/pygrib/_pygrib.cpython-311-darwin.so

输出中需包含eccodes的动态库路径（如/usr/local/lib/libeccodes.xxx.dylib），若缺失则说明链接失败，需重新编译。

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