py2app打包Python macOS应用启动报EXC_CRASH(SIGABRT)崩溃如何解决

故障特征 #

• 双击.app图标启动时直接崩溃，系统报错为EXC_CRASH (SIGABRT)
• 进入应用包目录，直接执行myapp.app/Contents/MacOS/myapp二进制文件时，系统拉起终端标签页后应用可正常运行

根因说明 #

该问题本质是两种启动方式的运行上下文不一致导致：

• 直接执行二进制时，应用继承终端的shell环境，会加载.zshrc/.bashrc里的自定义环境变量、PATH配置，工作目录为当前执行命令的目录，且会绕过部分LaunchServices的安全校验逻辑
• 双击.app启动时，应用由系统LaunchServices直接拉起，不会加载任何shell配置，工作目录默认为系统根目录/，会完整触发Gatekeeper安全校验、应用包结构校验逻辑，只要代码或打包配置不满足运行要求就会直接触发abort崩溃

修复步骤 #

按优先级逐一排查验证：

1. 修正资源路径读取逻辑
   所有内置资源禁止使用相对路径读取，统一通过运行时API定位资源目录，避免工作目录变化导致文件找不到：

   import os
   import sys
   
   def get_resource_path(rel_path):
       if getattr(sys, "frozen", False):
           # 打包后资源统一存放在app包的Resources目录下
           base_dir = os.path.normpath(os.path.join(os.path.dirname(sys.executable), "../Resources"))
       else:
           base_dir = os.path.dirname(os.path.abspath(__file__))
       return os.path.join(base_dir, rel_path)
   

2. 补全py2app打包配置
   检查setup.py的py2app配置项，缺失关键配置会直接导致LaunchServices拉起失败：

   from setuptools import setup
   
   setup(
       app=["myapp.py"],
       data_files=[],
       options={
           "py2app": {
               "argv_emulation": True, # 必须开启，模拟命令行参数传递逻辑
               "plist": {
                   "CFBundleExecutable": "myapp", # 必须和MacOS目录下的二进制文件名完全一致
                   "CFBundleName": "MyApp",
                   "CFBundleDisplayName": "MyApp",
                   # 无菜单栏的后台应用可添加该配置，避免Dock交互相关异常
                   # "LSUIElement": True,
               },
               # 若依赖第三方动态库、外部命令，显式加入打包列表
               # "includes": [],
               # "frameworks": [],
           }
       },
       setup_requires=["py2app"],
   )
   

   配置修改后删除旧的build、dist目录，重新执行打包命令。
3. 消除环境变量依赖
   不要依赖shell配置注入环境变量，在应用入口代码最开头显式声明需要的环境变量、补全PATH路径：

   import os
   # 把Homebrew等第三方工具路径加入默认PATH，避免调用外部命令时找不到
   os.environ["PATH"] = f"/opt/homebrew/bin:/usr/local/bin:{os.environ.get('PATH', '')}"
   

4. 绕过系统安全拦截
   macOS 12+版本的Gatekeeper会对未签名、未公证的应用做强制校验，打包完成后执行以下命令清除应用的隔离属性：

   xattr -cr ./dist/myapp.app
   

   若需要对外分发，建议使用苹果开发者ID对应用做签名和公证，避免终端用户侧触发拦截。
5. 精准定位崩溃点
   如果以上步骤都无法解决，在应用入口最开头添加日志重定向逻辑，把启动阶段的输出和报错写到固定日志文件：

   import sys
   import os
   log_file = open(os.path.expanduser("~/myapp_launch.log"), "a")
   sys.stdout = log_file
   sys.stderr = log_file
   

   重新打包后双击触发崩溃，直接查看用户目录下的myapp_launch.log，根据报错栈就能定位具体的触发代码。

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