如何让SpringBoot找到Ubuntu服务器中的Python包？

核心原因 #

命令行运行Python时依赖的是当前ubuntu用户的环境，flair模块安装在/home/ubuntu/.local/lib/python3.8/site-packages，但SpringBoot（尤其是WAR包部署到Tomcat的场景）通常以系统其他用户（比如tomcat）运行，该用户无法访问ubuntu用户的.local私有目录，且运行时不会自动继承当前用户的Python路径配置。

可行解决方案 #

1. 全局安装flair模块 #

用root权限将模块安装到系统全局目录，让所有用户的Python环境都能识别：

sudo pip3 install flair

全局安装的模块默认存放在/usr/local/lib/python3.8/site-packages，所有系统用户均可访问。

2. 手动指定PYTHONPATH环境变量 #

如果不想全局安装，可在SpringBoot调用Python的代码中，直接给进程设置PYTHONPATH，指向你的模块目录：

// 构建Python进程时注入环境变量
ProcessBuilder pb = new ProcessBuilder("python3", "your_script.py");
Map<String, String> env = pb.environment();
env.put("PYTHONPATH", "/home/ubuntu/.local/lib/python3.8/site-packages");
Process process = pb.start();

同时要确保SpringBoot运行用户有该目录的读取权限：

sudo chmod -R o+rX /home/ubuntu/.local/lib/python3.8/site-packages

3. 确认SpringBoot调用的Python版本 #

检查命令行和SpringBoot使用的Python版本是否一致：

• 命令行执行：which python3 和 python3 --version
• 在SpringBoot代码中打印Python版本验证：

ProcessBuilder pb = new ProcessBuilder("python3", "--version");
Process process = pb.start();
// 读取进程输出确认版本

如果版本不匹配（比如SpringBoot默认调用Python2），需明确指定调用python3，或调整PATH让它优先找到目标Python版本。

4. 使用Python虚拟环境 #

创建独立的虚拟环境安装flair，然后在SpringBoot中直接调用虚拟环境的Python解释器：

# 创建虚拟环境
python3 -m venv /opt/flair-venv
# 激活并安装依赖
source /opt/flair-venv/bin/activate
pip install flair
deactivate

SpringBoot代码中调用该虚拟环境的Python：

ProcessBuilder pb = new ProcessBuilder("/opt/flair-venv/bin/python", "your_script.py");
Process process = pb.start();

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