仅本机MacBook Pro出现gRPC客户端连接服务端Failed parsing HTTP/2错误

• 优先排查本地网络劫持类软件：关闭Mac上所有代理、VPN、抓包工具（如Clash、Surge、Charles、Shadowsocks等）后重试。这类软件如果开启了HTTP流量篡改规则，会往gRPC使用的HTTP/2帧中插入异常数据，正好对应服务端返回的Unknown frame type 71错误，是这类问题最常见的诱因。
• 对比gRPC依赖库版本：执行pip list | grep grpc查看本地grpcio、grpcio-tools的版本，确认和队友环境、服务端部署的版本完全一致。Mac环境下部分版本的gRPC库存在编译适配问题，如果版本不一致可以卸载后重新安装对应版本：pip install grpcio==[目标版本号] grpcio-tools==[目标版本号]。
• 验证底层HTTP/2链路连通性：执行curl -v --http2-prior-knowledge http://[服务端IP]:[服务端端口]测试链路，如果返回405方法不允许，说明HTTP/2底层链路正常，问题出在客户端gRPC封装层；如果curl也报错，说明是网络层问题，可进一步检查公司内网是否对该Mac的IP做了特殊流量限制，或者本地防火墙是否拦截了对应端口的请求。
• 排查TLS证书适配问题：如果你的gRPC服务开启了TLS加密，确认本地存储的证书文件和队友的完全一致，没有损坏或路径配置错误。Mac系统的钥匙串对自定义证书的信任策略和Windows/Linux不同，也可以临时切换为明文gRPC连接测试，验证是否为证书相关问题。
• 排除本地Python环境异常：如果你用的是brew安装的Python 3.9，可能存在依赖库链接异常的问题，可以用conda新建一个干净的虚拟环境，重新安装所有依赖后再运行代码，排除环境损坏的影响。

内容的提问来源于stack exchange，提问作者Y. Koh