Jenkins运行Snowflake脚本报错：No module named 'snowflake.connector'

API 探路者

2026-7-30

解决方案

1. 对齐Python执行环境

Jenkins使用的Python版本/路径可能和本地不一致，导致安装的依赖无法被脚本找到。

在Jenkins命令步骤中明确指定Python版本，安装依赖时用-m pip确保关联正确的Python环境：
```
python3 -m pip install snowflake-connector-python
```
先添加诊断步骤验证环境：
```
which python
which pip
pip list | grep snowflake
```
查看输出确认pip安装的依赖已存在，且Python路径和脚本执行时用的一致。

2. 解决依赖安装权限/路径问题

默认pip install可能将包安装到当前用户目录，但Jenkins运行用户（如jenkins）可能无法访问该路径，或者脚本执行时无法加载。

用--user参数指定安装到Jenkins用户的个人目录：
```
python -m pip install --user snowflake-connector-python
```
若有sudo权限，可全局安装确保所有用户都能访问：
```
sudo python -m pip install snowflake-connector-python
```

3. 用虚拟环境隔离依赖

创建独立虚拟环境，避免全局依赖冲突：

# 创建虚拟环境
python3 -m venv snowflake-venv
# 激活虚拟环境（Linux/macOS）
source snowflake-venv/bin/activate
# Windows环境执行：snowflake-venv\Scripts\activate
# 安装依赖
pip install snowflake-connector-python
# 执行数据脚本
python your_snowflake_script.py
# 可选：退出虚拟环境
deactivate