Jenkins未执行最后一条Shell命令问题排查求助

看起来你遇到的问题挺典型的——本地控制台跑完全正常，到Jenkins里就卡最后一步。我来帮你梳理几个最可能的原因和对应的排查解决方法：

1. 先确认Jenkins的工作路径是否匹配 #

你在本地执行命令时应该是在项目根目录，但Jenkins的默认工作目录是/var/lib/jenkins/workspace/你的项目名，如果hotels_report.py用的是相对路径，Jenkins可能找不到这个脚本。

• 排查&解决：
  • 在Jenkins的Shell步骤开头加一句pwd，查看当前工作目录。
  • 把最后一条命令改成基于Jenkins内置变量的绝对路径：

    python3 $WORKSPACE/testcases/HotelesCI/Desktop/HotelPlaya/hotels_report.py
    

    $WORKSPACE是Jenkins自带的环境变量，直接指向当前项目的工作目录，能避免路径混乱。

2. 虚拟环境激活可能未在非交互式Shell中生效 #

本地的Shell是交互式的，. bin/activate能正常切换虚拟环境，但Jenkins用的是非交互式Shell，激活脚本有时不会完全生效，导致后面的Python命令用的是系统全局环境，而非你创建的虚拟环境，可能引发依赖缺失或路径问题。

• 解决方法：绕开手动激活步骤，直接用虚拟环境内的Python解释器执行命令：

  python3 -m venv . && ./bin/pip install -r requirements.txt && ./bin/python -m pytest testcases/HotelesCI/Desktop/HotelPlaya --html=/home/jenkins/hoteles_playa_desktop.html --reruns 2 --self-contained-html --tb=line -k 'test_errors' ; ./bin/python testcases/HotelesCI/Desktop/HotelPlaya/hotels_report.py
  

  直接指定./bin/python和./bin/pip，确保全程用的是虚拟环境内的工具。

3. 检查Jenkins用户的权限问题 #

Jenkins默认以jenkins用户运行，这个用户可能没有访问报告文件路径或脚本的权限：

• 排查步骤：
  • 在Shell步骤里加whoami，确认当前执行用户是否为jenkins。
  • 检查/home/jenkins目录权限：在服务器上执行ls -ld /home/jenkins，若jenkins用户无读写权限，执行sudo chown jenkins:jenkins /home/jenkins修改。
  • 确保hotels_report.py有可读权限，必要时执行chmod +r testcases/HotelesCI/Desktop/HotelPlaya/hotels_report.py。

4. 捕获命令的错误输出 #

Jenkins没显示最后一条命令的输出，大概率是命令执行出错但错误信息未被捕获。你可以修改最后一条命令，把输出和错误都写入日志：

python3 testcases/HotelesCI/Desktop/HotelPlaya/hotels_report.py >> /home/jenkins/report_exec_log.txt 2>&1

之后去服务器查看这个日志文件，就能知道是脚本找不到、依赖缺失还是其他具体问题。

5. 检查Jenkins的构建终止规则 #

虽然你用了分号（理论上不管前面命令成功失败都会执行后续命令），但如果Jenkins配置了“任意步骤失败就终止构建”的选项，还是可能打断后续命令。

• 临时排查方案：给pytest命令加|| true，强制返回成功码，确保后续命令能执行：

  pytest ... --tb=line -k 'test_errors' || true ; python3 ...hotels_report.py
  

  注意这只是排查用，后续还是要关注pytest的实际执行状态。

6. 确认Python环境的一致性 #

本地的Python3和Jenkins中的Python3可能版本不同、依赖安装位置不同。你可以在Jenkins的Shell步骤里加以下命令，和本地输出对比：

which python3
python3 --version
pip3 list

如果环境不一致，可能需要在Jenkins中指定和本地一致的Python路径。

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