Mac环境下SpringBoot调用Python报spacy模块找不到错误求助

Mac 环境下 Tomcat 作为系统服务运行时，其环境变量（PATH、PYTHONPATH）和你手动在终端操作时的用户环境变量完全隔离，不会加载 ~/.zshrc、~/.bash_profile 等配置里的路径。这导致 SpringBoot 用 exec() 调用的 Python 是系统默认版本，而非你安装了 spacy、gensim 等依赖的 Python 环境。

1. 直接指定 Python 解释器的绝对路径 #

• 先在终端执行 which python3 或 which python，找到你安装了依赖的 Python 绝对路径，比如 /usr/local/bin/python3 或 /Users/xxx/miniconda3/bin/python3
• 修改 SpringBoot 中的 exec() 调用代码，把原来的 python/python3 替换成这个绝对路径：

  // 示例代码
  Process process = Runtime.getRuntime().exec(new String[]{
      "/usr/local/bin/python3",  // 替换为你的Python绝对路径
      "/path/to/your_script.py"
  });
  

2. 显式设置 PYTHONPATH 环境变量 #

如果指定绝对路径后仍找不到库，需手动告诉 Python 依赖包的位置：

• 在终端执行 python3 -c "import sys; print('\n'.join(sys.path))"，找到包含 spacy、gensim 的 site-packages 路径，比如 /usr/local/lib/python3.9/site-packages
• 在 Java 代码中通过 ProcessBuilder 设置环境变量：

  ProcessBuilder pb = new ProcessBuilder("/usr/local/bin/python3", "/path/to/your_script.py");
  Map<String, String> env = pb.environment();
  // 替换为你的site-packages路径，多个路径用冒号分隔
  env.put("PYTHONPATH", "/usr/local/lib/python3.9/site-packages");
  Process process = pb.start();
  

3. 使用虚拟环境隔离依赖（推荐） #

用虚拟环境可以彻底避免环境冲突问题：

• 创建虚拟环境：python3 -m venv /path/to/your/venv
• 激活并安装依赖：

  source /path/to/your/venv/bin/activate
  pip install spacy gensim
  python -m spacy download en_core_web_sm
  

• 在 exec() 中直接调用虚拟环境的 Python 路径：/path/to/your/venv/bin/python3

4. 检查 Tomcat 运行用户权限 #

Mac 下 Tomcat 默认以系统用户（如 _www）运行，可能无法访问你个人目录下的 Python 环境。可以：

• 将 Python 环境安装到系统公共路径（如 /usr/local/）
• 修改 Tomcat 的运行用户为你的当前登录用户

在 Python 脚本开头添加以下代码，捕获输出后对比终端运行结果，快速定位路径问题：

import sys
import os
print("Python 路径:", sys.executable)
print("PYTHONPATH:", os.environ.get("PYTHONPATH"))
print("Python 搜索路径:", sys.path)

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