Azure同容器内Blob目录调整及AzCopy复制失败问题咨询

问题背景 #

现有存储结构：

Container
   |-> Application (目录)
           |-> Build (子目录)
                  |-> Release (子目录)
                           |-> build.tar.gz 

计划调整为按环境区分的结构：

Container
   |-> Application (目录)
           |-> Build (子目录)
                |-> dev / pre prod / prod (子目录)
                     |-> Release (子目录)
                           |-> build.tar.gz 

尝试用AzCopy复制时因目标目录不存在报错，错误信息翻译为：

创建一个或多个目标容器失败。如果容器已存在，你的传输仍可能成功。

解决方案 #

方案1：AzCopy自动创建虚拟目录（推荐） #

Azure Blob存储的目录是虚拟结构，无需提前手动创建，只要AzCopy命令的目标路径正确，会自动生成对应虚拟目录。之前报错大概率是路径中的空格（如pre prod）未正确处理，修正命令格式即可：

从原结构复制到dev目录

azcopy copy "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/Release/build.tar.gz" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/dev/Release/build.tar.gz" --recursive

从dev复制到pre prod目录（处理空格）

方法1：用引号包裹含空格的路径

azcopy copy "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/dev/Release/build.tar.gz" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/pre prod/Release/build.tar.gz" --recursive

方法2：对空格进行URL编码（替换为%20）

azcopy copy "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/dev/Release/build.tar.gz" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/pre%20prod/Release/build.tar.gz" --recursive

从pre prod复制到prod目录

azcopy copy "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/pre prod/Release/build.tar.gz" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/prod/Release/build.tar.gz" --recursive

方案2：提前创建虚拟目录（可选） #

如果需要提前确认路径结构存在，可通过上传空占位文件生成虚拟目录：

Windows系统

azcopy copy "NUL" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/dev/Release/.placeholder"
azcopy copy "NUL" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/pre prod/Release/.placeholder"
azcopy copy "NUL" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/prod/Release/.placeholder"

Linux/macOS系统

azcopy copy "/dev/null" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/dev/Release/.placeholder"
azcopy copy "/dev/null" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/pre%20prod/Release/.placeholder"
azcopy copy "/dev/null" "https://<存储账户名>.blob.core.windows.net/<容器名>/Application/Build/prod/Release/.placeholder"

创建完成后再执行复制命令即可避免报错。

方案3：Azure PowerShell复制 #

若习惯用PowerShell，可使用Start-AzStorageBlobCopy命令：

$storageAccountName = "<存储账户名>"
$containerName = "<容器名>"
$context = New-AzStorageContext -StorageAccountName $storageAccountName -UseConnectedAccount

# 复制到dev
Start-AzStorageBlobCopy -SrcBlob "Application/Build/Release/build.tar.gz" -SrcContainer $containerName `
  -DestBlob "Application/Build/dev/Release/build.tar.gz" -DestContainer $containerName `
  -Context $context

# 从dev复制到pre prod
Start-AzStorageBlobCopy -SrcBlob "Application/Build/dev/Release/build.tar.gz" -SrcContainer $containerName `
  -DestBlob "Application/Build/pre prod/Release/build.tar.gz" -DestContainer $containerName `
  -Context $context

# 从pre prod复制到prod
Start-AzStorageBlobCopy -SrcBlob "Application/Build/pre prod/Release/build.tar.gz" -SrcContainer $containerName `
  -DestBlob "Application/Build/prod/Release/build.tar.gz" -DestContainer $containerName `
  -Context $context

注意事项 #

• 确保使用**AzCopy v10+**版本，旧版本对虚拟目录的支持不完善
• 自动化场景可将命令集成到Azure DevOps流水线、Azure Function或逻辑应用中，实现环境间的自动复制
• 路径中的特殊字符（如空格）必须正确处理，否则会导致路径解析错误

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