本地通过Jenkins运行nosetests失败，报ImportError: No module named错误

我来帮你搞定这个头疼的问题！本地终端能正常跑的脚本，到Jenkins就报ImportError: No module named，基本都是环境不一致惹的祸——毕竟Jenkins运行时的用户、环境变量、工作路径和你自己的终端 session 完全不一样。下面是几个一步步排查的方案：

1. 明确指定Python工具的绝对路径 #

你本地终端里的nosetests和python可能是虚拟环境里的版本，但Jenkins默认用的是系统全局的，版本或者依赖不一样就会找不到模块。先在自己的终端里跑这两个命令拿到完整路径：

which python
which nosetests

然后把脚本里的nosetests替换成拿到的绝对路径，比如：

/Users/<user>/your-venv/bin/nosetests -s --tc-file=/Users/<user>/eddie-qa/automation/mobile_automation/configs/local_config_android_galaxy_6_0.py --tc-format python mobile_automation.tests.login_logout.tests_login_logout:TestLogin.test_05_incorrect_username_login

2. 手动把项目目录加入Python路径 #

Python找不到模块，大概率是因为项目根目录不在它的搜索路径里。在脚本的nosetests命令之前，添加一行把项目目录加到PYTHONPATH：

export PYTHONPATH="/Users/<user>/eddie-qa/automation:$PYTHONPATH"

这样Python就能找到你的mobile_automation模块了。

3. 检查Jenkins的工作目录与权限 #

• 工作目录问题：Jenkins的默认工作目录可能不是你脚本里的路径，虽然你加了cd /Users/<user>/eddie-qa/automation，但保险起见可以在脚本开头打印当前目录确认：pwd，看看是不是预期的路径。
• 权限问题：Jenkins运行时的用户（比如jenkins用户）可能没有访问你的项目目录的权限。可以给项目目录添加可读权限：

chmod -R +r /Users/<user>/eddie-qa/automation

如果需要写入权限，再加上+w。

4. 确保Appium在Jenkins环境中可用 #

本地终端里appium能跑，但Jenkins的PATH里可能没包含appium的安装路径。同样先在本地终端跑which appium拿到绝对路径，然后替换脚本里的appium &：

/usr/local/bin/appium &  # 替换成你自己的appium路径

5. 调试Jenkins的环境差异 #

如果上面的方法都没用，就直接对比Jenkins和本地终端的环境差异。在Jenkins的构建步骤里先加一个shell命令，打印关键信息：

echo "Jenkins PATH: $PATH"
echo "Jenkins Python path: $(which python)"
python -c "import sys; print('Python search paths:', sys.path)"

然后把这些输出和你本地终端里跑同样命令的结果对比，就能一眼看出哪里不一样了——比如PATH少了虚拟环境目录，或者PYTHONPATH没包含项目路径。

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