Azure Synapse Notebook Spark集群安装Python库（holidays/fugue）失败求助

一、PyPI连接超时的核心原因 #

• 网络访问限制：即便你认为集群无限制，实际可能存在VNet的NSG规则、防火墙拦截了集群到pypi.org的443端口出站请求，或是集群未配置公网访问权限。
• 默认源访问不稳定：pypi.org的默认节点在部分网络环境下延迟过高，导致连接超时。
• 代理配置缺失：若你的环境需要代理才能访问公网，但Synapse Notebook未配置代理参数，会直接导致无法连接PyPI。

二、找不到fugue匹配版本的原因 #

• Python版本不兼容：fugue对Python版本有明确要求（如需3.7及以上），若集群使用的Python版本过低，pip会找不到对应的兼容包。
• 架构不匹配：Synapse集群的底层架构（如ARM64）若没有对应的fugue预编译WHL包，pip会尝试源码编译，而编译过程依赖C编译器等工具，缺失依赖则会失败，最终提示无匹配版本。
• 本地WHL包不兼容：你使用的WHL包版本与集群的Python版本、硬件架构不匹配，导致无法安装。

三、可行的解决步骤 #

针对连接超时 #

1. 检查集群VNet的出站规则，确保允许访问pypi.org:443。
2. 更换国内PyPI镜像源，执行命令：%pip install holidays fugue -i https://pypi.tuna.tsinghua.edu.cn/simple
3. 若需代理，添加代理参数：%pip install holidays fugue --proxy http://你的代理地址:端口

针对版本不匹配 #

1. 先确认集群Python版本：%python --version，再选择fugue的兼容版本安装，例如：%pip install fugue==0.8.6（版本号需匹配你的Python版本）
2. 检查集群架构：%uname -m，下载对应架构的WHL包后再尝试安装。
3. 若需源码编译，通过集群初始化脚本安装gcc等编译依赖工具。

内容的提问来源于stack exchange，提问作者Walbersy Navarro Valladares