Python 3.12的_ssl模块缺失导致pip失效，根本原因是编译前未安装libssl-dev（Debian/Ubuntu）或openssl-devel（CentOS/RHEL），致使configure阶段静默禁用_ssl和hashlib模块。
Python 3.12 的 _ssl 模块缺失导致 pip 失效
编译安装完 Python 3.12 后执行 pip install 报错，根本原因常是 _ssl 模块没编译进去。这不是 pip 本身的问题，而是 Python 解释器启动时就缺了 SSL 支持 —— 导致所有走 HTTPS 的网络操作（包括 pip 获取包、requests.get("https://")）全部失败。
典型现象：ModuleNotFoundError: No module named '_ssl'，紧接着 pip install 直接退出，连错误堆栈都打不全。
- 根本原因是编译前没装
openssl-devel（CentOS/RHEL）或libssl-dev（Debian/Ubuntu），导致 configure 阶段自动禁用_ssl和hashlib模块 - 检查方法：运行
./configure --help | grep ssl，如果输出里没有--with-openssl或类似开关，说明 OpenSSL 头文件压根没被发现 - 修复不是重跑
make install，而是删掉整个 build 目录，重新./configure --with-openssl=/usr（路径按实际调整），再make -j$(nproc)
PyO3 v0.21 + Python 3.12 编译失败的路径污染问题
用 PyO3 写 Rust 扩展时，cargo build 突然报找不到 pyconfig.h 或链接失败，大概率不是 PyO3 版本不对，而是构建缓存里混进了旧 Python 版本的 target-dir 或项目根目录下残留了 __pypackages__。
PyO3 v0.21 明确支持 Python 3.12，但它的 pyo3-build-config 会优先读取环境变量和本地配置，一旦 PYTHON_SYS_EXECUTABLE 指向旧版本 Python，或 __pypackages__/3.11/lib 被误加载，就会触发 ABI 不匹配。
立即学习“Python免费学习笔记（深入）”；
- 先清理：删除项目下的
target、__pypackages__、venv（如有），再确认which python3输出的是你刚装的 3.12 路径 - 显式指定 Python：在
Cargo.toml里加[dependencies.pyo3]段，写死version = "0.21"，并确保python-version = "3.12"在[package.metadata.pyo3]中 - 避免全局污染：不要在 shell 配置里硬编码
PYTHONPATH，PyO3 构建时依赖python3-config输出，而不是环境变量
Alpine Linux 下 cffi/cryptography 编译失败：gcc 缺失不是唯一原因
在 python:3.12-alpine 镜像里 pip install cryptography 报 command 'gcc' failed，很多人只想到装 build-base，但实际失败可能发生在更底层 —— openssl-dev 和 libffi-dev 版本与 Python 3.12 不兼容。
Alpine 的 apk 包管理器默认提供的是 musl libc 版本的开发库，而 cryptography 从 42.x 开始要求 OpenSSL 3.0+ 和 libffi 3.4+，但 Alpine 3.19 的 openssl-dev 是 3.3.0，libffi-dev 却还是 3.4.4 —— 表面能装，链接时却因符号版本不一致崩溃。
- 必须同时安装：
apk add build-base openssl-dev libffi-dev cargo（cargo是 PyO3 项目的额外依赖） - 如果仍失败，临时降级 cryptography：
pip install cryptography==41.0.7（最后一个全面支持 OpenSSL 1.1.1 的版本） - 生产镜像别留
build-base：多阶段构建时，只在 builder 阶段装，final 阶段用apk del .build-deps清理，否则镜像体积暴增且带安全风险
pkgutil.ImpImporter 移除引发的 setuptools 兼容性断裂
AttributeError: module 'pkgutil' has no attribute 'ImpImporter' 这个错误在 Python 3.12 下高频出现，不是你的代码错了，而是你用的 setuptools 版本太老 —— 它还在调用已被彻底移除的 API。
Python 3.12 彻底删除了 pkgutil.ImpImporter，这是 PEP 562 和 PEP 632 推进的结果。但很多旧版 setuptools（如 ）、<code>numpy（）、甚至某些内部封装的 <code>setup.py 脚本，仍硬编码了这个导入路径。
- 最快解法：
pip install --upgrade setuptools==68.2.2（当前最新稳定版，已完全适配 3.12） - 如果升级后仍有问题，检查
requirements.txt里是否锁死了旧版setuptools或pkg_resources，删掉显式版本约束 - 注意：不要用
pip install --force-reinstall setuptools==67.0.0，那个“兼容版”只是临时补丁，有已知的 wheel 构建缺陷，尤其在 CI 环境中容易触发subprocess-exited-with-error
最易被忽略的一点：Python 3.12 的模块编译失败，往往不是单点问题，而是环境链上多个环节松动 —— openssl-devel 缺失影响 _ssl，_ssl 缺失让 pip 失效，pip 失效又导致你无法及时升级 setuptools，setuptools 升级失败又反过来让 C 扩展无法生成 wheel。排查时得顺着这条链反向验证，不能只盯最后一条报错。
