Jenkins运行Python单元测试报找不到'main'模块错误解决方案求助

这个问题的核心是本地开发环境与Jenkins CI环境的Python搜索路径规则差异：

• 本地PyCharm运行测试时，会自动将存放main.py的项目根目录加入Python模块搜索路径，因此导入逻辑可正常执行
• Jenkins环境直接执行python3 unit_tests/test_main.py时，Python默认只会把当前运行脚本所在的unit_tests/目录作为搜索起点，不会向上检索项目根目录的模块文件，最终触发ModuleNotFoundError。

你之前参考的多数方案会建议修改服务器全局Python环境变量，这类操作需要服务器登录权限，不适用当前场景。

所有方案都可通过修改仓库内代码或Jenkinsfile实现，不需要登录Jenkins服务器调整全局环境配置：

方案1：测试脚本内主动注入项目根路径 #

修改unit_tests/test_main.py，在所有业务导入语句前添加路径注入逻辑，让脚本运行时自动定位项目根目录：

import sys
from pathlib import Path

# 自动计算当前测试文件对应的项目根目录（上上级路径）
PROJECT_ROOT = Path(__file__).parent.parent.resolve()
# 将项目根目录插入到Python搜索路径的最优先位置
sys.path.insert(0, str(PROJECT_ROOT))

# 原有导入逻辑保持不变
import unittest.mock
from main import MainFunction
from nose.tools import assert_is_not_none, assert_is_none, assert_equal

class TestMainLogic(unittest.case):
    ~~~ 测试代码占位 ~~~

该方案适配所有运行环境，只要项目文件结构不发生变动，导入逻辑不会失效。

方案2：流水线执行时临时指定搜索路径 #

如果不想修改测试脚本，可直接调整Jenkinsfile中test阶段的执行命令，通过Python专用的路径环境变量PYTHONPATH临时指定搜索根目录：
将原test阶段的执行命令：

sh 'python3 unit_tests/test_main.py'

替换为：

sh 'PYTHONPATH=. python3 unit_tests/test_main.py'

这里的.指代Jenkins流水线checkout代码后的当前工作目录（即存放main.py的项目根目录），该方式不需要修改任何全局环境配置，适配多节点的Jenkins流水线。

方案3：使用Python官方推荐的测试发现机制执行 #

放弃直接运行子目录脚本的方式，从项目根目录调用Python内置的测试发现能力启动测试，该机制会自动将项目根目录加入搜索路径，从根源规避导入问题：
对应修改Jenkinsfile的test阶段命令为：

sh 'python3 -m unittest discover -s unit_tests -p "test_*.py"'

补充：如果项目使用pytest作为测试执行框架，等价的命令为python3 -m pytest unit_tests/，同样可以正确识别项目根目录的模块路径。

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