跳转到主要内容

修复 macOS 中的开发者验证错误

默认情况下,对于从互联网下载的应用程序或工具,除非已由经过认证的开发者签名并通过 Apple 公证,否则 macOS 不会运行它们。 从 26.7.4 发行版开始 (以及 26.8 及之后的所有发行版) ,ClickHouse 的 macOS 构建均使用 ClickHouse Inc. 的 Developer ID 签名,并已通过 Apple 公证。这些构建发布在 GitHub 发行版页面上,文件名分别为 clickhouse-macos.zip (Intel) 和 clickhouse-macos-aarch64.zip (Apple silicon) ,Homebrew cask 安装的也是这些构建。如果您使用的是其中之一,macOS 会直接运行 clickhouse,不会显示任何警告,您也无需执行本文中的任何操作。 如果您运行的是已被 macOS 隔离的未签名二进制文件,仍可能遇到该错误,例如:
  • 通过 Homebrew 安装的旧版 ClickHouse 发行版——运行 brew upgrade --cask clickhouse 以获取已签名的版本;
  • 使用网页浏览器从 GitHub 发行版页面下载的自解压 clickhouse-macos 或 clickhouse-macos-aarch64 二进制文件——请改为下载同一发行版的 .zip 文件;
  • 使用网页浏览器下载的早于 26.7.4 的发行版。
通过 curl https://clickhouse.com/ | sh 安装的二进制文件虽未签名,但 curl 不会隔离其下载的文件,因此 macOS 运行它时不会出现此错误。 尝试运行已被隔离的 clickhouse 二进制文件时,您可能会看到以下错误:
MacOS 开发者验证错误对话框
如果无法改用已签名的构建,请通过系统设置或终端解除该二进制文件的隔离。

系统设置流程

  1. 先尝试运行一次 clickhouse 二进制文件,让 macOS 显示上述错误并记录被阻止的二进制文件。
  2. 打开系统设置。
  3. 前往隐私与安全:
    MacOS 隐私与安全设置默认视图
  4. 向下滚动到安全部分,找到一条消息:“clickhouse-macos-aarch64” 因并非来自已识别的开发者而被阻止使用。
  5. 点击仍要允许 (在较新的 macOS 版本中为仍要打开) 。
    MacOS 隐私与安全设置中显示“仍要允许”按钮
  6. 输入你的 macOS 用户密码。
现在,你应该可以在终端中运行 clickhouse 命令了。下次运行时,macOS 可能会要求你再确认一次。

终端操作

如果点击系统设置中的按钮仍无法解决该问题,或者你更喜欢使用命令行,可以使用 xattr 移除该二进制文件上的隔离属性。 如果 clickhouse 位于你的 PATH 中,请先找出它所在的位置:
应会输出类似如下内容:
运行 xattr -d com.apple.quarantine,再加上上一条命令返回的路径,即可将 clickhouse 从隔离区中移除:
你现在应该已经可以运行 clickhouse 可执行文件:
应会输出类似如下内容: