如何配置Python项目目录结构以解决Jenkins运行pytest报错问题？

我正在开发一个Python项目，计划通过pytest和Jenkins实现自动化测试。项目的目录结构如下：

project/
  src/
    __init__.py
    hello.py
    input.py
    person.py
  test/
    test_hello.py

在项目根目录下直接运行pytest时一切正常，但通过Jenkins执行测试时，持续出现错误，截取的错误日志如下：

[-1_10-finish-basic-ci-setup-IIB3G6YENVYIQDST5MPMDBNVOZLYD6VSLP5ZCT6VUVQSNZJKGYEA]
Running shell script

• python src/hello.py true
  Traceback (most recent call last):
  File "s...

问题分析与解决方案 #

从错误日志里能看到一个关键问题：Jenkins执行的命令是python src/hello.py true，但你本地运行的是pytest——这明显是构建步骤配置出错了，大概率是你在Jenkins里没设置正确的测试命令。下面是具体的排查和解决步骤：

1. 修正Jenkins构建命令 #

检查Jenkins的「Execute shell」构建步骤，确保命令是在项目根目录下运行pytest，而不是直接执行hello.py脚本。正确的命令应该类似：

# 先切换到项目根目录（如果Jenkins工作目录不是这里的话）
cd ${WORKSPACE}
# 运行pytest
pytest

如果你的项目依赖虚拟环境，记得先激活：

cd ${WORKSPACE}
source venv/bin/activate  # Linux/macOS环境
# venv\Scripts\activate.bat  # Windows环境
pytest

2. 确保Python环境一致 #

本地和Jenkins的Python环境可能存在差异，比如：

• 本地用Python3，Jenkins默认调用Python2
• Jenkins环境里没安装pytest或项目依赖包

解决方法：

• 明确指定Python版本运行pytest：python3 -m pytest
• 在构建步骤里先安装依赖：pip install pytest（如果有requirements.txt，直接用pip install -r requirements.txt统一安装）

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

• 确认Jenkins的工作目录确实指向你的项目根目录，否则会出现路径找不到的问题
• 检查项目目录的权限，确保Jenkins运行的用户拥有读取、执行项目文件的权限

如果能提供完整的错误日志，还能更精准地定位问题，但目前来看，构建命令配置错误是最可能的原因，先修正这个试试。

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