You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

macOS下Tauri应用代码签名后启动显示空白窗口问题

解决Tauri macOS沙箱签名后空白窗口问题

启用com.apple.security.app-sandbox权限后出现空白窗口,核心原因是沙箱默认限制了应用读取自身包内资源的权限,Tauri的前端页面(HTML/CSS/JS)无法被加载,导致窗口空白。

修复步骤:

  1. 更新entitlements.plist,补充必要权限
    给沙箱添加允许读取应用容器资源的权限,同时根据需求添加网络权限:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
        <key>com.apple.security.app-sandbox</key>
        <true/>
        <!-- 必须:允许读取应用自身包内的所有资源 -->
        <key>com.apple.security.files.app-container.read-only</key>
        <true/>
        <!-- 可选:如果应用需要联网请求,添加此项 -->
        <key>com.apple.security.network.client</key>
        <true/>
    </dict>
    </plist>
    
    • com.apple.security.files.app-container.read-only:是加载本地前端资源的必备权限,没有它沙箱会阻止应用读取自身bundle里的文件。
    • com.apple.security.network.client:如果你的应用需要发起网络请求,必须添加,否则会出现网络请求失败的问题。
  2. 重新编译签名应用
    在src-tauri目录下执行构建命令,确保新的权限配置被应用:

    cargo tauri build
    
  3. 验证修复效果
    打开构建后的应用包,确认窗口能正常加载内容。

额外检查项:

  • 确认tauri.conf.json中entitlements的路径正确,你的配置"../entitlements.plist"(假设文件在项目根目录,src-tauri为子目录)是正确的。
  • 如果仍有问题,可以查看系统控制台(Console.app)中应用的日志,搜索沙箱相关的错误信息,定位缺少的权限。

内容的提问来源于stack exchange,提问作者Ostap Brehin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.31 12:23:03