Azure Batch池BlobDownloadMiscError求助：启动任务失败

一、BlobDownloadMiscError的核心原因 #

这个报错基本和存储账户的访问权限或网络配置挂钩，常见两种情况：

• 存储账户开了防火墙/虚拟网络限制，Batch计算节点的IP不在允许访问的范围内
• 资源文件的Blob URL没有附带有效的SAS令牌，且存储容器未开启匿名访问（不建议开匿名）

二、分步解决方法 #

1. 检查存储账户的网络访问设置 #

登录Azure门户找到目标存储账户，进入「网络」选项：

• 如果设置的是「选定的网络」，确认是否把Batch账户所在的虚拟网络、或者计算节点的公网IP段加入了允许列表；可以临时切换为「所有网络」做测试（测试完成后再改回安全配置）
• 要是Batch池部署在专用虚拟网络内，必须确保存储账户允许该VNet的流量访问

2. 给资源文件生成SAS令牌 #

存储容器默认是私有的，必须给ZIP文件生成带读取权限的SAS令牌：

• 在存储账户的Blob容器里找到目标ZIP文件，右键选择「生成SAS」
• 权限只勾选「读取」，设置合适的过期时间，生成完整的SAS URL
• 回到Batch池的启动任务配置，把原来的Blob URL替换成这个带SAS的URL

3. 完善启动任务的解压脚本 #

就算文件下载成功，还要确保启动任务里有把模块解压到正确路径的命令，示例：

# 解压Import-Excel模块到PowerShell系统模块目录
Expand-Archive -Path .\Import-Excel.zip -DestinationPath "C:\Program Files\WindowsPowerShell\Modules" -Force
# 解压SqlServer模块
Expand-Archive -Path .\SqlServer.zip -DestinationPath "C:\Program Files\WindowsPowerShell\Modules" -Force

把这段命令加到启动任务的「命令行」里，保证模块被放到计算节点能识别的PowerShell模块目录中

三、应用包方案的修复 #

之前应用包找不到文件的问题，大概率是打包格式不对：

• 应用包的ZIP文件必须直接包含模块的根目录，比如解压Import-Excel的ZIP后，要直接看到Import-Excel文件夹（里面包含.psd1、.psm1等核心文件），不能是多层文件夹嵌套
• 上传应用包到Batch账户后，在池配置里指定该应用包，启动任务中用Batch内置的环境变量调用，示例：

Expand-Archive -Path "%AZ_BATCH_APP_PACKAGE_ImportExcel%\\Import-Excel.zip" -DestinationPath "C:\Program Files\WindowsPowerShell\Modules" -Force

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