无GUI环境下运行Mac .app捆绑应用报错，求解决方案

错误原因分析 #

你遇到的错误：

+[NSXPCSharedListener endpointForReply:withListenerName:replyErrorCode:]: an error occurred while attempting to obtain endpoint for listener 'ClientCallsAuxiliary': Connection interrupted

本质是：这类.app捆绑应用基于Cocoa/AppKit框架构建，即便不显示GUI窗口，也依赖Mac GUI会话中的核心系统服务（比如LaunchServices提供的XPC通信端点、Window Server上下文）。无GUI的SSH会话默认没有这些服务的访问权限，导致XPC连接中断。苹果并未完全禁止这类场景，但需要匹配正确的运行上下文。

解决方案 #

方案1：在GUI用户会话上下文运行

通过launchctl asuser命令让程序继承当前登录GUI用户的会话环境，步骤如下：

1. 获取当前GUI用户的UID：

   id -u $(stat -f%Su /dev/console)
   

2. 用该UID直接运行.app内的可执行文件：

   launchctl asuser <获取到的UID> ./Myapp.app/Contents/MacOS/Myapp
   

3. 若需用open命令启动.app包：

   launchctl asuser <获取到的UID> open -n ./Myapp.app
   

注：-n参数用于避免启动已存在的应用实例，确保新进程在正确上下文运行

方案2：重构为纯命令行工具

如果应用仅需终端输出日志、无任何GUI依赖，可彻底移除AppKit框架依赖，改为纯Foundation命令行工具：

• 在Xcode中创建新的「Command Line Tool」项目
• 将原应用的业务逻辑迁移到新项目，使用main函数直接初始化Foundation，无需调用NSApplicationMain
• 编译后生成的可执行文件可直接在SSH会话中运行，完全脱离GUI会话限制

方案3：临时关闭App Sandbox（若启用）

若应用开启了App Sandbox，无GUI会话下可能被限制访问系统XPC服务：

1. 打开Xcode项目，进入「Signing & Capabilities」面板
2. 找到「App Sandbox」选项并关闭
3. 重新编译应用后，在SSH中测试运行

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