fix(macos): 修复 Release 版因沙箱缺少网络权限导致无法连接后端 #28

Merged
Morris merged 1 commits from fix/macos-release-sandbox-network into main 2026-11-19 19:59:04 +08:00
Owner

问题

macOS 发布版(Release)启动后界面提示「无法连接后端」。

根因

Release.entitlements 启用了 App Sandbox(com.apple.security.app-sandbox),但未声明 com.apple.security.network.client。沙箱内进程向 127.0.0.1:17890 的本地后端发起出站 HTTP 请求时被内核拒绝(EPERM)。

Debug 配置(DebugProfile.entitlements)含 network.server,因此开发时正常,问题仅在打包 Release 后暴露。

复现:codesign -d --entitlements :- GC-UI.app 可看到签名中仅有 app-sandbox,无任何 network 权限。

修改

  1. GC-UI/frontend/macos/Runner/Release.entitlements:新增 com.apple.security.network.client 与 com.apple.security.network.server。
  2. GC-UI/frontend/macos/Runner.xcodeproj/project.pbxproj:部署目标 10.14 → 12.0,兼容 Xcode 27(最低支持 12.0)。

验证

重新构建 Release 并启动 GC.app 后,lsof -nP -a -p <GC-UI PID> -iTCP 显示:

GC-UI  ...  TCP 127.0.0.1:xxxxx->127.0.0.1:17890 (ESTABLISHED)

前端成功建立到后端的连接,界面正常加载,不再提示无法连接。

## 问题 macOS 发布版(Release)启动后界面提示「无法连接后端」。 ## 根因 `Release.entitlements` 启用了 App Sandbox(`com.apple.security.app-sandbox`),但未声明 `com.apple.security.network.client`。沙箱内进程向 `127.0.0.1:17890` 的本地后端发起出站 HTTP 请求时被内核拒绝(EPERM)。 Debug 配置(`DebugProfile.entitlements`)含 `network.server`,因此开发时正常,问题仅在打包 Release 后暴露。 复现:`codesign -d --entitlements :- GC-UI.app` 可看到签名中仅有 `app-sandbox`,无任何 network 权限。 ## 修改 1. `GC-UI/frontend/macos/Runner/Release.entitlements`:新增 `com.apple.security.network.client` 与 `com.apple.security.network.server`。 2. `GC-UI/frontend/macos/Runner.xcodeproj/project.pbxproj`:部署目标 `10.14` → `12.0`,兼容 Xcode 27(最低支持 12.0)。 ## 验证 重新构建 Release 并启动 GC.app 后,`lsof -nP -a -p <GC-UI PID> -iTCP` 显示: ``` GC-UI ... TCP 127.0.0.1:xxxxx->127.0.0.1:17890 (ESTABLISHED) ``` 前端成功建立到后端的连接,界面正常加载,不再提示无法连接。
Morris added 1 commit 2026-11-19 19:58:42 +08:00
fix(macos): Release 版补 network 权限,修复启动后无法连接后端
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
3efdf74258
- Release.entitlements 增加 com.apple.security.network.client / network.server:
  发布版启用 App Sandbox 但缺少 network.client 时,前端向 127.0.0.1 后端的
  出站 HTTP 请求会被内核拒绝,表现为打开界面即提示“无法连接后端”。
- project.pbxproj 部署目标 10.14 -> 12.0,兼容 Xcode 27(最低支持 12.0)。
Morris merged commit 01c2d017c6 into main 2026-11-19 19:59:04 +08:00
Morris deleted branch fix/macos-release-sandbox-network 2026-11-19 19:59:07 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#28