You need to enable JavaScript to run this app. Apple M1 Silicon(arm64)下安装GRPCIO构建失败的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

Apple M1 Silicon(arm64)下安装GRPCIO构建失败的解决方法

问题根因

grpcio 1.34.0 存在两个适配缺陷,是构建失败的核心原因:

  • 该版本发布时未适配macOS arm64(Apple Silicon)架构,没有提供对应平台的预编译二进制包,安装时默认触发本地源码编译流程
  • 源码编译逻辑存在bug:读取macOS SDK目标版本时遇到非字符串值触发TypeError,同时BoringSSL的ASM构建流程无法识别macosx-11-arm64平台参数,直接终止编译
  • 通过direnv激活的是原生arm64架构的Python虚拟环境,没有额外的架构适配配置,因此才会触发本地编译的报错。
无需等待官方更新的可落地方案

方案1:强制匹配x86_64预编译包(最快生效)

通过环境变量修改包管理器的平台匹配逻辑,绕过arm64源码编译流程:

  • 在项目的.envrc文件中追加配置:
    # 固定包构建时的目标架构为x86_64
    export ARCHFLAGS="-arch x86_64"
    # 强制pip仅拉取预编译二进制包,不触发源码编译
    export PIP_ONLY_BINARY=:all:
    
  • 执行direnv allow加载配置后,先清理Poetry缓存中残留的grpcio源码包缓存:
    poetry cache clear pypi --package grpcio
    
  • 重新执行依赖安装即可,此时包管理器会自动匹配x86_64版本的grpcio预编译wheel,不会触发本地源码编译流程。

注意:如果配置后仍然触发源码编译,需要退出当前终端,在终端程序的“显示简介”设置中勾选“使用Rosetta打开”,重新进入项目目录触发direnv环境加载,确保整个shell进程运行在x86_64模式下。

方案2:显式声明兼容arm64的grpcio版本

如果不想依赖Rosetta转译,可以通过版本覆盖跳过存在构建bug的旧版grpcio:

  • grpcio 1.35.0版本已修复旧版setup.py中mac_target解析的TypeError问题,1.38.0版本开始正式提供arm64架构的预编译包。
  • 在项目的pyproject.toml中显式添加grpcio的版本约束,覆盖上游依赖的旧版本要求:
    [tool.poetry.dependencies]
    grpcio = ">=1.38.0"
    
  • 配置完成后执行direnv allow,再运行poetry update grpcio,包管理器会自动解析到无构建bug的arm64预编译版本,不会触发本地编译流程。

方案3:提前预装符合版本要求的预编译包

如果上游依赖强制要求grpcio版本在>=1.34,<1.38区间,无法直接升级到1.38以上版本,可以手动预装对应版本的预编译包:

  • 安装时跳过源码编译,直接拉取macOS arm64平台的wheel包:
    pip install --only-binary=:all: --platform macosx_11_0_arm64 "grpcio==1.36.1"
    
  • 预装完成后再执行项目正常的依赖安装流程,包管理器会检测到已安装符合版本要求的grpcio,不会重新触发源码编译。

内容的提问来源于stack exchange,提问作者reka18

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 22:45:02