Pyenv环境下Python 3.10在macOS M3芯片的SSL连接问题解决方案

在macOS系统上使用Pyenv管理Python版本时，部分用户可能会遇到一个典型的SSL证书验证问题。当通过Pyenv安装Python 3.10.16版本并在M3芯片的Mac设备上创建虚拟环境后，执行pip升级操作时会出现AttributeError: 'NoneType' object has no attribute 'get'错误。

这个问题的根源在于Python与OpenSSL库的兼容性。在macOS系统上，特别是使用Apple Silicon芯片的设备，系统自带的SSL库可能无法与通过Pyenv编译安装的Python版本完美配合。错误信息显示在urllib3库尝试建立HTTPS连接时，无法正确获取证书的subjectAltName属性。

解决方案的核心是重新编译Python并明确指定使用Homebrew提供的OpenSSL 3.x版本。通过设置环境变量PYTHON_BUILD_HOMEBREW_OPENSSL_FORMULA=openssl@3，可以强制Pyenv在编译Python时链接到正确版本的OpenSSL库。

具体操作步骤如下：

1. 首先确保系统已安装Homebrew和openssl@3：

   brew install openssl@3
   

2. 设置环境变量后重新安装Python：

   PYTHON_BUILD_HOMEBREW_OPENSSL_FORMULA=openssl@3 pyenv install 3.10.16
   

3. 创建新的虚拟环境并验证问题是否解决：

   python3 -m venv new-venv
   source new-venv/bin/activate
   python3 -m pip install -U pip
   

这个问题在Python 3.12等较新版本中不会出现，因为这些版本已经更新了对现代SSL库的支持。对于需要特定Python 3.10环境的开发者，上述解决方案提供了一个可靠的解决途径。

值得注意的是，这类SSL相关问题在跨平台开发中并不罕见，特别是在涉及安全连接的场景下。开发者应当保持开发环境的依赖库更新，并了解不同版本间的兼容性差异，以确保开发流程的顺畅。通过正确配置编译选项，可以避免许多潜在的运行时问题。