pip项目在macOS 10.12及更早版本上的安装问题解析

在pip 24.2版本中，macOS 10.12及更早版本的用户遇到了一个严重的安装问题。这个问题源于pip内部集成的truststore组件与旧版macOS系统API的兼容性问题。

问题现象

当用户在macOS 10.12或更早版本上使用pip 24.2安装软件包时，会遇到以下错误：

AttributeError: dlsym(0x7f8bab7b33d0, SecTrustEvaluateWithError): symbol not found

这个错误表明pip尝试调用macOS安全框架中一个不存在的API函数SecTrustEvaluateWithError。该函数是在macOS 10.13中引入的，因此在更早的版本上不可用。

技术背景

pip 24.2引入了一个名为truststore的组件，用于替代传统的证书验证机制。truststore旨在提供更安全的证书验证方式，直接使用系统原生证书存储而非Python的certifi包。然而，truststore在macOS上的实现使用了较新的Security框架API，这些API在macOS 10.12及更早版本上不可用。

影响范围

这个问题影响所有在以下环境中的pip使用：

• macOS 10.12 (Sierra)及更早版本
• pip 24.2版本
• 任何Python版本（因为问题出在pip本身）

临时解决方案

在官方修复发布前，用户可以采用以下临时解决方案：

1. 降级pip到24.1.2版本：

python3 -m pip install --use-deprecated=legacy-certs pip==24.1.2

2. 使用legacy证书验证模式：

python3 -m pip install --use-deprecated=legacy-certs <package>

根本解决方案

truststore项目已经修复了这个问题，新版本会检测系统版本并回退到兼容的API。pip 24.3版本已经包含了修复后的truststore组件，解决了这个兼容性问题。

对Python发行版的影响

这个问题特别影响了Python 3.12.5-3.12.7的macOS安装包，因为这些版本默认捆绑了pip 24.2。Python官方在3.12.5的macOS安装包中加入了特殊处理，在检测到旧版macOS时会自动降级pip。

最佳实践建议

对于仍在使用macOS 10.12或更早版本的用户：

1. 优先考虑升级操作系统到受支持的版本
2. 如果无法升级系统，确保使用pip 24.3或更高版本
3. 对于Python 3.12.x用户，可以考虑使用Python 3.11或更早版本，这些版本不受此问题影响

总结

这个案例展示了软件兼容性维护的重要性，特别是当引入依赖系统原生功能的新特性时。开发者在设计跨平台功能时需要充分考虑不同平台和版本间的差异，而用户在使用新版本软件时也应注意可能的兼容性问题。