手动安装grpcio成功但requirements.txt指定版本安装失败求助

• 版本兼容性冲突：grpcio 1.62.2和grpcio-tools 1.62.2是2024年3月发布的版本，完全未适配Python 3.12及以上版本的内部API变更。Python 3.12对_PyDict_SetItem_KnownHash、_PyLong_AsByteArray这类C扩展API的签名做了调整甚至部分废弃，而1.62.2版本的grpc代码仍沿用旧的调用方式，编译时直接触发符号找不到、参数不匹配的错误。
• 手动安装与requirements安装的本质差异：手动执行pip install grpcio时，pip会自动检测当前Python版本，拉取与当前Python兼容的最新grpc稳定版（而非1.62.2），这些新版本已经适配了Python 3.12+的API，甚至直接提供预编译好的wheel包，无需本地编译；但requirements.txt锁死了1.62.2版本，pip只能尝试从源码编译该旧版本，触发兼容性报错。
• 预编译wheel包缺失：针对你当前的Python版本/系统架构，grpcio 1.62.2可能没有现成的预编译wheel包，pip被迫走源码编译流程，而源码中的C代码与当前Python API不兼容，最终导致cl.exe编译失败。

• 将requirements.txt中的grpc版本升级到1.64.0及以上（该版本开始正式支持Python 3.12），替换为grpcio>=1.64.0和grpcio-tools>=1.64.0。
• 如果必须使用1.62.2版本，需将Python降级到3.11或更低版本，确保API调用匹配。

内容的提问来源于stack exchange，提问作者mulberry