Mac终端执行`brew doctor`报`openssl@1.1`警告

发现问题

Mac(M1)终端安装HomeBrew后,执行brew doctor报警告:

zsh 复制代码
lndu@iMac ~ % brew doctor

Please note that these warnings are just used to help the Homebrew maintainers

with debugging if you file an issue. If everything you use Homebrew for is

working fine: please don't worry or file an issue; just ignore this. Thanks!

  


Warning: Some installed formulae are deprecated or disabled.

You should find replacements for the following formulae:

  openssl@1.1
lndu@iMac ~ %

分析上述警告信息,Homebrew 提示 openssl@1.1 被弃用或禁用,主要是因为 macOS 系统自身已经提供了 LibreSSL,而 Homebrew 的 openssl@1.1 是"keg-only"的,这意味着它不会被默认链接到系统路径中以避免冲突。

使用已弃用的软件包,暂时可能不影响使用,但从长期来看,存在安全风险或兼容性问题,还是有必要升级一下openssl版本。

PS:弃用库的原因通常有:

  • 上游项目不再维护
  • 存在未修复的安全漏洞,例如 CVE
  • 发布了新版本,例如openssl或openssl@3
  • 有了更好的替代方案

解决问题

整体思路是:优先迁移到新的openssl版本,如果暂时无法迁移(例如需要使用依赖openssl@1.1的特定库),作为临时方案,为旧版本设置正确的环境变量。

【长期方案】升级openssl版本

Step0 检查依赖关系

通过下面命令,找出依赖于openssl@1.1的库,并记录下来,后面可能需要重新安装它们。

zsh 复制代码
brew deps --tree openssl@1.1
Step1 搜索新版本
zsh 复制代码
brew search openssl
Setp2 安装新版本

选择一个新版本安装,例如

zsh 复制代码
brew install openssl

或

zsh 复制代码
brew install openssl@3.0
Setp3 重新安装依赖软件

还记得Step0中记录下来的那些依赖软件吗?重新安装它们,HomeBrew通常会尝试自动为她们使用最新的依赖关系。

zsh 复制代码
brew install ca-certificates
Step4 完成✅

最后别忘了再运行一下HomeBrew检查脚本

zsh 复制代码
brew doctor

【临时方案】设置环境变量

为了确保使用 openssl@1.1 的软件能找到它(因为"keg-only"),需要手动在 shell 配置文件(如 ~/.zshrc)中设置相关环境变量。

Step0 设置环境变量

针对 Apple Silicon Mac,依次执行:

zsh 复制代码
export PATH="/opt/homebrew/opt/openssl@1.1/bin:$PATH" # 将 OpenSSL 1.1 的二进制文件加入 PATH
export LDFLAGS="-L/opt/homebrew/opt/openssl@1.1/lib" # 链接器查找库的路径
export CPPFLAGS="-I/opt/homebrew/opt/openssl@1.1/include" # 编译器查找头文件的路径
export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl@1.1/lib/pkgconfig" # pkg-config 查找 .pc 文件的路径

针对 Intel Mac ,对应的路径通常为 /usr/local/opt/openssl@1.1。

Step1 加载使配置生效
zsh 复制代码
source ~/.zshrc

最终目标:卸载openssl@1.1

当确定所有软件都不再依赖 openssl@1.1 后,卸载它以消除brew doctor检查的警告。

zsh 复制代码
brew uninstall openssl@1.1
相关推荐
wuxianda10302 天前
Swift 项目用 Xcode 脚手架起步:默认工程结构和依赖组合为什么会被识别成同源
开发语言·xcode·swift·4.3a·appstore审核
镰刀韭菜3 天前
2026 年 10 月 Mac 本地大模型:24GB / 64GB / 128GB 怎么选
mac·qwen·apple silicon·ollama·本地llm
Ceelog3 天前
CleanBit 安全高效的 Mac 磁盘清理助手
mac
CocoaKier3 天前
苹果开发者注意,请在2027年1月31日前完成合规验证,否则中国区可能下架
ios·aigc·apple
Bowen_J4 天前
Apple Foundation Models:Apple AI核心框架
人工智能·ai编程·apple
csdn_aspnet6 天前
macOS 10 、Docker 玩轉 MySQL
运维·mysql·macos·docker·容器·mac
Cooper256 天前
DDC 命令成功但屏幕不动:用 gamma 表重做亮度映射
python·mac
goehou6 天前
两台 Mac 拼成推理池,加机器不加内存
mac·集群·ollama·本地推理
fthux10 天前
总想着“忙完再休息”?让 Tick Rest 提醒你,先歇一会儿
开源·github·mac·swift·提醒·消息提醒·tick rest·tick rest for mac·消息提醒app
流浪00111 天前
计算机网络篇23:数据链路层——以太网帧格式与 MAC 地址,MTU 牵住 UDP 和 TCP,ARP 拿 IP 换 MAC
计算机网络·mac·数据链路层·arp·mtu·局域网通信