Jenkins Execute Shell下无法创建并激活Python虚拟环境问题咨询

你遇到的报错分为两层：

1. 第一层ModuleNotFoundError: No module named 'virtualenv.seed.embed.via_app_data'是Ubuntu 20.04源自带的virtualenv版本和系统Python版本存在兼容性问题，导致虚拟环境创建失败
2. 后续的目录不存在、激活文件不存在报错，都是因为第一步虚拟环境创建失败、生成的目录结构不完整导致的

解决方案 #

方案一：替换老旧版本virtualenv #

1. 先卸载系统源安装的旧版本virtualenv

sudo apt remove -y python3-virtualenv

2. 用pip安装最新稳定版virtualenv

sudo pip3 install virtualenv

如果系统未安装pip3，先执行：

sudo apt install -y python3-pip

方案二：直接使用Python3自带的venv模块（兼容性最佳） #

Python3.3以上版本自带官方虚拟环境模块venv，无需额外安装第三方包，完全可以替代virtualenv使用，避免版本兼容问题。

修正后的Jenkins Execute Shell脚本 #

#!/bin/bash
# 清理之前创建失败的残留目录
rm -rf virtual_django1
# 方案一用virtualenv创建的命令（二选一即可）
# virtualenv -p python3 virtual_django1
# 方案二用venv创建的命令
python3 -m venv virtual_django1
# 直接用路径激活虚拟环境，无需切换目录减少出错
source ./virtual_django1/bin/activate
# 以下是验证步骤，可根据需要删除
echo "虚拟环境激活成功，当前Python路径："
which python
echo "当前pip版本："
pip -V

注意事项 #

• 确认Jenkins用户对当前任务工作目录有读写权限，若权限不足可执行：

sudo chown -R jenkins:jenkins /var/lib/jenkins/workspace/你的任务名称

• 不要手动修改Jenkins工作目录的权限为777，避免安全风险
• Jenkins的shell执行环境为非登录非交互式shell，尽量使用绝对路径调用命令和文件，避免环境变量不一致导致的报错
• Jenkins执行shell时使用的是独立的jenkins用户环境，和你本地登录系统的用户环境完全独立，本地测试正常的命令不代表在Jenkins环境中可以正常运行，安装依赖包时尽量做全局安装，或者配置jenkins用户的私有pip源和依赖路径

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