Ubuntu系统Jupyter Notebook中griddb_python安装失败求助

问题重现 #

在Ubuntu系统中，使用Python 2.7.18或3.9在Jupyter Notebook中安装griddb_python时，出现编译wheel失败的错误，核心报错片段：

Defaulting to user installation because normal site-packages is not writeable
Collecting griddb_python
...
Building wheel for griddb_python (setup.py) ... error
error: subprocess-exited-with-error
× python setup.py bdist_wheel执行失败，退出码为1
...
swigging src/griddb.i to src/griddb_wrap.cpp
swig -python -DSWIGWORDSIZE64 -c++ -outdir . -Isrc -o src/griddb_wrap.cpp src/griddb.i
...

原因分析 #

griddb_python是基于C扩展的库，安装时需要本地编译，依赖以下组件：

• SWIG（用于生成Python与C++的绑定代码）
• 基础编译工具（gcc、g++等）
• GridDB的C开发库

同时系统默认site-packages不可写，导致只能用用户安装模式，可能影响编译环境的路径配置。

解决方案 #

1. 安装编译依赖 #

打开终端，执行以下命令安装必要的系统依赖：

sudo apt update
sudo apt install build-essential swig libgriddb-dev

• build-essential提供gcc、g++等编译工具
• swig用于生成Python-C++绑定代码
• libgriddb-dev是GridDB的C开发库，编译griddb_python必须依赖

2. 使用虚拟环境避免权限问题（推荐） #

创建并激活虚拟环境，避免全局权限问题：

Python 3.9

python3.9 -m venv griddb-env
source griddb-env/bin/activate

Python 2.7

virtualenv -p python2.7 griddb-env27
source griddb-env27/bin/activate

激活后，直接安装griddb_python：

pip install griddb_python

3. 若仍失败，指定GridDB库路径 #

如果系统中GridDB库路径未被自动识别，手动指定环境变量后安装：

export LD_LIBRARY_PATH=/usr/lib/griddb:$LD_LIBRARY_PATH
pip install griddb_python

4. Jupyter中使用虚拟环境 #

安装虚拟环境的kernel，以便在Jupyter中使用：

pip install ipykernel
python -m ipykernel install --user --name=griddb-env

重启Jupyter后，即可选择对应的kernel使用griddb_python。

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