PyInstaller打包后Pytest-xdist陷入死循环，无法正常运行求助

核心排查与修复方案 #

• 禁用pytest-xdist多进程：pytest-xdist的多进程机制在打包环境下易触发进程fork递归问题，直接导致无限循环。可在打包后运行程序时添加-n 0参数强制单进程执行，或者临时移除pytest-xdist依赖，用纯pytest运行测试。
• 修正.spec文件配置：确保spec文件没有重复触发测试执行的逻辑，同时显式添加pytest相关隐式依赖，避免打包时遗漏关键模块：

  # test_case.spec 示例修正
  a = Analysis(
      ['test_case.py'],
      pathex=[],
      binaries=[],
      datas=[],
      hiddenimports=['pytest', '_pytest', '_pytest.config', '_pytest.mark'],
      hookspath=[],
      hooksconfig={},
      runtime_hooks=[],
      excludes=[],
      noarchive=False,
  )
  pyz = PYZ(a.pure)
  exe = EXE(
      pyz,
      a.scripts,
      a.binaries,
      a.datas,
      [],
      name='test_case',
      debug=False,
      console=True,  # 保留控制台输出，方便定位循环日志
      strip=False,
      upx=True,
      runtime_tmpdir=None,
      argv_emulation=False,
  )
  

• 添加调试日志定位循环点：在测试脚本关键位置插入日志输出，打包后运行查看控制台，确认循环发生在测试初始化、用例执行还是pytest内部逻辑：

  # test_case.py 调试代码示例
  import pytest
  import logging
  
  logging.basicConfig(level=logging.INFO)
  logger = logging.getLogger(__name__)
  
  logger.info("脚本启动")
  
  def test_demo():
      logger.info("执行测试用例")
      assert 2 + 2 == 4
  
  if __name__ == "__main__":
      logger.info("调用pytest执行测试")
      pytest.main([__file__])
      logger.info("测试执行结束")
  

环境适配调整 #

• 修改pytest调用方式：避免直接在__main__中调用pytest.main()，改用显式参数限制pytest的自动行为：

  pytest.main([__file__, '--no-header', '--no-summary', '--tb=short'])
  

• 降级PyInstaller版本：部分高版本PyInstaller对pytest的动态导入处理存在bug，可尝试降级到5.10.1版本：

  pip uninstall pyinstaller -y && pip install pyinstaller==5.10.1
  

特殊场景排查 #

• 检查测试用例循环逻辑：确认本地运行正常的用例，是否因打包后路径、环境变量变化触发了隐性循环（比如依赖相对路径失败后无限重试）。
• 禁用pytest自动发现：在pytest.main中指定具体测试用例，避免递归发现测试文件引发的循环：

  pytest.main(['test_case.py::test_demo'])
  

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