求助：使用Pybuilder运行Python单元测试报错，手动执行setup.py正常

看起来你遇到的核心矛盾是：Pybuilder构建环节一切正常，但单元测试执行失败，可手动通过setup.py install却能让测试完美运行——确实，按预期Pybuilder应该自动处理setup.py的生成与安装，手动操作显然不是长久之计。下面是几个针对性的排查和解决思路：

1. 确认测试任务与安装任务的依赖关系 #

Pybuilder默认的run_unit_tests任务本应依赖install任务，但如果你的build.py里自定义了任务逻辑，可能不小心破坏了这个依赖链：

• 检查你的build.py，如果有自定义测试任务，确保用@depends("install")装饰器明确绑定依赖：

  from pybuilder.core import task, depends
  
  @task("run_unit_tests")
  @depends("install")
  def custom_run_unit_tests(project, logger):
      # 保留或调用默认的测试执行逻辑即可
      pass
  

• 执行pyb tasks查看任务依赖树，确认run_unit_tests下方是否列出install作为前置依赖。

2. 查看详细构建日志，排查安装环节的静默错误 #

有时候安装步骤可能存在隐性错误（比如权限不足、依赖版本冲突），但没有在控制台显式抛出：

• 执行pyb -v run_unit_tests查看 verbose 日志，重点关注install阶段的输出，确认安装是否真的完整完成，有没有被忽略的报错信息。

3. 检查测试执行的环境一致性 #

Pybuilder默认会启用虚拟环境（如果配置开启），但如果手动安装是在全局环境，而测试在虚拟环境中运行，就会出现环境不一致的问题：

• 检查build.py里的虚拟环境配置：

  project.set_property("virtualenv_enabled", True)  # 确认是否开启虚拟环境
  project.set_property("virtualenv_location", ".venv")  # 查看虚拟环境的具体路径
  

• 激活对应的虚拟环境，手动执行测试命令，看是否能复现问题；或者直接查看虚拟环境的site-packages目录，确认项目包是否已经被正确安装进去。

4. 调整测试的导入路径配置 #

如果你的单元测试使用了绝对导入（比如from my_project.module import ...），但Pybuilder没有把项目源码目录添加到测试的sys.path中，就会出现导入错误——手动安装后包被放到site-packages，自然能正常导入：

• 在build.py里添加配置，让测试阶段能直接访问源码目录：

  project.set_property("unittest_additional_pythonpath", ["src/main/python"])
  

• 或者在测试文件开头临时添加路径：

  import sys
  from pathlib import Path
  sys.path.insert(0, str(Path(__file__).parent.parent / "src" / "main" / "python"))
  

5. 强制清理缓存并重新构建 #

有时候旧的构建缓存会干扰新的安装流程，尝试彻底清理后重新执行：

• 执行pyb clean install run_unit_tests，先清空之前的构建产物，再重新完成安装与测试流程。

如果以上方法都没能解决问题，建议补充单元测试的具体报错信息（比如导入错误、缺失依赖提示等），以及你的build.py内容，这样能更精准地定位问题根源。

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