Azure Web Service部署时通过requirements.txt安装torch报错如何解决

• 该后缀是PyTorch官方对特定硬件适配编译版本的专属标识，+cpu代表该版本为仅支持CPU运行、无CUDA依赖的轻量化编译版本
• 这类定制化编译的安装包不会上传至公共PyPI源，仅托管在PyTorch官方的软件源中，因此直接在公共PyPI站点无法检索到对应版本，未配置额外源直接写入requirements.txt安装时就会提示找不到对应安装包。

1. 优先排查超时问题 #

你遇到的748MB大包下载超时是Azure App Service部署的常见触发原因：默认部署的空闲超时时间较短，大体积依赖下载过程中很容易触发超时中断，直接返回未知错误。你可以先做以下验证：

• 进入对应Web应用的「配置」-「应用设置」，新增配置项SCM_COMMAND_IDLE_TIMEOUT，值设置为3600（单位为秒，即延长空闲超时至1小时），保存后重新发起部署，确认是否为超时导致的部署失败。

2. 拉取完整部署日志排查根因 #

Azure门户展示的诊断日志仅做摘要展示，完整的pip安装错误日志需要通过Kudu控制台获取：

• 进入Web应用左侧菜单栏的「高级工具」，点击「前往」打开Kudu管理界面
• 依次进入Debug console -> CMD，打开/home/LogFiles/kudu/deployment目录，找到对应部署时间的日志文件，里面会记录pip安装全流程的详细输出，包括依赖冲突、网络中断、磁盘配额不足等具体报错信息。

3. 本地复现排查环境兼容问题 #

你本地为Windows开发环境，自动生成的requirements.txt会适配本地的依赖编译版本，和Azure上默认的Linux运行环境存在兼容性差异：

• 你可以本地创建和Azure运行时Python版本完全一致的虚拟环境，手动执行pip install -r requirements.txt复现安装过程，就能快速定位具体报错原因。

如果想要避免大体积包下载的问题，可以直接用轻量化的CPU版本torch，仅需要修改requirements.txt：

1. 在requirements.txt第一行添加--extra-index-url https://download.pytorch.org/whl/cpu
2. 保留torch、torchvision版本后的+cpu后缀
   修改后安装的CPU版本torch体积仅为几十MB，不会触发下载超时问题，也能匹配Web应用无GPU的运行环境。

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