Mac 上的“curl: (35) SSL connect error”

curl 退出码 35 表示某个步骤失败。curl 文档的说法是:“A problem occurred somewhere in the SSL/TLS handshake.”

让你的智能体来解决拷贝一条提示词,适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题:Mac 上的“curl: (35) SSL connect error”。请阅读 https://kilobat.app/zh-hans/guides/curl-35-ssl-connect-error.md,并和我一起逐步处理。如果缺少 Kilobat CLI,请安装:brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于:所有当前 macOS 版本上 macOS 自带的 curl 和 Homebrew 版 curl。核查日期:2026年10月29日

症状

  • 终端显示 curl: (35) SSL connect error,或者更长的消息,例如 LibreSSL SSL_connect。
  • 连接已经打开,但安全握手失败。
  • 脚本以退出码 35 停止。

可能的原因

  • 代理或过滤器。检查 TLS 的代理或安全类 App 可能会破坏握手。
  • 端口或协议不对。URL 使用 https,但该端口提供的是普通 HTTP。
  • 时钟不对。时钟偏差很大会导致证书检查失败。
  • 服务器的 TLS 故障。服务器使用的 TLS 配置可能不被 curl 接受。

如何检查

  1. 用详细信息运行 curl。错误缓冲区中的文字能指出问题所在。

    curl -v https://example.com
  2. 检查日期。

    date
  3. 用 OpenSSL 测试握手。

    openssl s_client -connect example.com:443 -servername example.com
  4. 试试 http:// 来测试端口。

如何修复

  1. 使用正确的协议和端口。

  2. 在 System Settings › General › Date & Time 下把时钟设为自动。

  3. 为了测试,暂时关闭安全软件中的 TLS 扫描,之后再打开。

  4. 换一个网络试试。

使用 Kilobat

  1. Kilobat 的连接诊断会逐层测试这个地址:网络、代理、DNS、规则、IPv4、IPv6、TLS 和服务器,并指出失败的那一层。

    kilobat why https://example.com
  2. Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用 diagnose_connection 和 diagnose_network 运行它们。请参阅找出某个网站或 API 连不上的原因。

常见问题

为什么要用 curl -v 查看错误文字?

curl 文档说明,错误缓冲区中的消息能更准确地指出问题。

(35) 和 (60) 一样吗?

不一样。35 表示握手失败,60 表示证书检查失败。参见Mac 上的“curl: (60) SSL certificate problem”。

参考资料

核查日期:2026 年 10 月 29 日。