Swift集成PythonKit：Release归档后因模块导入崩溃

我开发了一款Mac应用，用Swift实现界面、Python实现核心功能，引入PythonKit作为依赖后完成以下配置：

• 在「Signing & Capabilities」中移除「App Sandbox」
• 关闭「Enable Hardened Runtime」
• 设置环境变量PYTHON_LIBRARY为/opt/homebrew/bin/python3.11

直接在Xcode中运行项目一切正常，但通过「归档→分发→自定义→复制App」流程生成的安装包，打开后瞬间崩溃。崩溃报告显示问题出在PythonAPI.init()第24行的main = Python.import("main")代码。

我有两个疑问：

1. 为什么直接运行正常，归档分发后就崩溃？
2. system.path.append使用了绝对路径，其他用户安装App时路径不同该如何处理？

我尝试将「Strip Style」设置为仅保留「Debugging Symbols」但无效，也未找到「Enable Bitcode」选项尝试关闭。

崩溃报告 #

---

Translated Report (Full Report Below) #

Version: 1.0 (1)
Code Type: ARM-64 (Native)
Parent Process: launchd [1]

OS Version: macOS 14.0 (23A344)
Report Version: 12

Exception Type: EXC_BREAKPOINT (SIGTRAP)
Exception Codes: 0x0000000000000001, 0x000000019f534658

Termination Reason: Namespace SIGNAL, Code 5 Trace/BPT trap: 5
Terminating Process: exc handler [97502]

Thread 0 Crashed:: Dispatch queue: com.apple.main-thread
0 libswiftCore.dylib 0x19f534658 assertionFailure(::file:line:flags:) + 268
1 libswiftCore.dylib 0x19f5a0cf8 swift_unexpectedError + 516
2 Filex 0x102576428 PythonInterface.import(:) + 148 (Python.swift:707)
3 Filex 0x10256f7e8 PythonAPI.init() + 568 (PythonAPI.swift:24)
4 Filex 0x10256f5a4 PythonAPI.__allocating_init() + 44
5 Filex 0x102541a30 implicit closure #2 in implicit closure #1 in variable initialization expression of Main._pythonAPI + 28
6 SwiftUI 0x1bb15ab5c 0x1ba412000 + 13929308

崩溃代码位置 #

public init() {        
   // Initialize Python
   system = Python.import("sys")
   system.path.append("/Users/reidhtaylor/Documents/Projects/Python/Filex/FilexBackend")
        
   // Get main file
   main = Python.import("main") //!!!! AT THIS LINE #24 !!!!//
}

一、归档后崩溃的原因及修复 #

核心原因 #

1. 硬编码路径失效：你代码中写的/Users/reidhtaylor/Documents/Projects/Python/Filex/FilexBackend是开发机器上的本地路径，分发后的App bundle中不存在这个目录，Python执行import main时找不到文件，触发断言失败导致崩溃。
2. 外部Python依赖不可靠：设置的PYTHON_LIBRARY指向本地Homebrew的Python路径，其他用户机器可能没有这个路径，或因权限问题无法访问；且归档后的App无法继承开发环境的变量配置，导致PythonKit初始化异常。

修复步骤 #

1. 将Python代码打包进App bundle：
   • 把FilexBackend文件夹添加到Xcode项目中，勾选对应App target的「Target Membership」。
   • 在「Build Phases」→「Copy Bundle Resources」中确认包含该文件夹，确保编译时会复制到App bundle内。
2. 打包独立Python运行时：
   • 从Homebrew复制Python框架（如/opt/homebrew/Cellar/python@3.11/3.11.x/Frameworks/Python.framework）到项目中，添加到「Frameworks, Libraries, and Embedded Content」，设置「Embed」为「Embed & Sign」。
   • 在Swift代码中动态设置Python库路径，避免依赖外部环境：

     // 先设置Python库路径
     if let pythonFrameworkPath = Bundle.main.path(forResource: "Python", ofType: "framework", inDirectory: "Contents/Frameworks") {
         let pythonLibPath = "\(pythonFrameworkPath)/Versions/3.11/Python"
         setenv("PYTHON_LIBRARY", pythonLibPath, 1)
     }
     // 初始化PythonKit
     Python.initialize()
     

二、路径适配问题处理 #

用动态获取App bundle路径的方式替代硬编码，确保所有用户的环境都能正确找到Python代码：

public init() {        
   // Initialize Python
   Python.initialize()
   let system = Python.import("sys")
   
   // 动态获取bundle内的后端代码路径
   guard let backendPath = Bundle.main.path(forResource: "FilexBackend", ofType: nil) else {
       fatalError("无法找到Python后端代码目录")
   }
   system.path.append(backendPath)
        
   // 导入main模块
   main = Python.import("main")
}

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