Python2转Python3兼容适配时pyz文件运行找不到__main__模块问题

适配场景 #

正在进行Python2项目向Python3的迁移，同时保留Python2兼容性，已完成基础适配工作：

• 缩进格式统一调整
• print语句转函数式写法适配
• 基于six库的跨版本导入适配
  项目通过Makefile生成预置Python头的zip格式可执行包（即pyz包），包根目录下已存在__main__.py入口文件。

异常现象 #

• Python3运行pyz包报错：/usr/bin/python3: can't find '__main__' module in 'proj.pyz'
• 直接运行项目内__main__.py文件无异常
• Python2运行同一份pyz包完全正常

根因定位 #

项目包内存在为Python2适配自行实现的runpy.py脚本，Python3解释器加载pyz包时会优先调用包内的自定义脚本，而非系统标准库的runpy模块，导致__main__模块加载逻辑异常。

解决方案 #

删除项目包内自定义的runpy.py脚本即可解决该问题，不影响原有Python2兼容逻辑。

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