如何处理AzCopy生成的.azDownload前缀文件？PowerShell脚本问题

先搞懂这些文件的由来 #

AzCopy下载Blob时，针对大文件会创建.azDownload+GUID格式的临时文件，用来分块存储下载内容。正常情况下，下载完成后AzCopy会自动把这个临时文件重命名为原Blob的文件名。但如果出现以下情况，临时文件就会残留甚至变成“错误命名的合法文件”：

• 下载过程中网络中断、脚本意外终止、AzCopy进程被强行关闭
• 目标文件夹权限不足，导致下载完成后无法完成重命名操作
• AzCopy旧版本存在重命名逻辑的bug
• 目标路径已有同名文件且处于锁定状态，无法覆盖重命名

处理现有问题文件 #

1. 区分有效文件与无效临时文件 #

• 对比文件大小：如果.azDownload+GUID文件的大小和Azure Blob中原文件的大小完全一致，基本可以确定是下载完成但未成功重命名的合法文件；如果大小远小于原文件，就是未完成的临时下载文件，直接删除即可。
• 查看文件内容（可选）：对于文本类文件，可以直接打开确认内容是否完整，判断是否为有效文件。

2. 批量重命名合法文件 #

用PowerShell批量去掉.azDownload+GUID前缀，恢复原文件名（注意根据你实际的前缀格式调整正则表达式）：

# 替换成你的下载目标路径
$targetPath = "D:\AzureBlobDownloads"

Get-ChildItem -Path $targetPath -Filter ".azDownload*" | ForEach-Object {
    # 提取原文件名：去掉开头的.azDownload-xxxxxx-部分（示例格式，根据实际调整）
    $originalFileName = $_.Name -replace '^\.azDownload-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-', ''
    # 跳过提取后为空的情况
    if (-not [string]::IsNullOrEmpty($originalFileName)) {
        $newPath = Join-Path $_.DirectoryName $originalFileName
        Rename-Item -Path $_.FullName -Destination $newPath -Force
        Write-Host "已重命名：$($_.Name) -> $originalFileName"
    }
}

3. 清理无效临时文件 #

批量删除未完成的临时文件（可根据原文件平均大小设置阈值）：

$targetPath = "D:\AzureBlobDownloads"
# 设置大小阈值，比如100MB（单位是字节）
$sizeThreshold = 100 * 1024 * 1024

Get-ChildItem -Path $targetPath -Filter ".azDownload*" | 
    Where-Object { $_.Length -lt $sizeThreshold } | 
    Remove-Item -Force -Verbose

预防后续出现此类问题 #

• 升级AzCopy到最新版：旧版本可能存在重命名逻辑的bug，直接覆盖安装最新稳定版即可。
• 确保目标文件夹权限：运行脚本的账户必须拥有目标文件夹的读写、修改权限，避免重命名时权限不足失败。
• 启用断点续传：调用AzCopy下载时加上--resume参数，即使下载中断，下次启动时会继续未完成的部分，完成后自动重命名：

  azcopy copy "https://youraccount.blob.core.windows.net/container/blobpath" "D:\Downloads" --resume
  

• 添加脚本错误处理：在PowerShell脚本中捕获AzCopy的退出码，非0时触发重试或检查逻辑：

  $azCopyExitCode = (Start-Process azcopy -ArgumentList "copy 'https://xxx.blob.core.windows.net/container/file' 'D:\Downloads\file'" -Wait -PassThru).ExitCode
  if ($azCopyExitCode -ne 0) {
      Write-Warning "AzCopy下载出现异常，退出码：$azCopyExitCode"
      # 这里可以添加重试逻辑，或者检查临时文件的处理逻辑
  }
  

• 避免同名文件冲突：下载前先检查目标路径是否存在同名文件，要么用--overwrite true参数强制覆盖，要么跳过该文件：

  azcopy copy "https://youraccount.blob.core.windows.net/container/blobpath" "D:\Downloads" --overwrite true
  

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