Azure Blob Storage的az storage copy遇同名文件夹与文件时复制失败

问题根源 #

Azure Blob存储采用扁平架构，所谓的“文件夹”是基于Blob名称前缀的虚拟概念。当容器中已存在data_source/前缀的虚拟文件夹时，az storage copy的--recursive参数会将data_source识别为目录，自动跳过对同名单个Blob文件的复制操作，导致该文件无法同步到目标容器。

可行解决方案 #

方案1：拆分复制流程 #

分两次执行命令，先单独处理同名文件，再递归复制其余内容：

1. 单独复制同名文件（无需--recursive参数）：

   az storage copy -s "$SRC/data_source" -d "$DEST/data_source"
   

2. 递归复制其余文件夹，同时排除该同名文件避免冲突：

   az storage copy -s "$SRC" -d "$DEST" --recursive --exclude "data_source"
   

方案2：直接操作单个Blob #

使用az storage blob copy命令单独处理该文件，绕开递归模式的目录识别逻辑：

az storage blob copy start --source-uri "$SRC_BLOB_URI" --destination-container "$DEST_CONTAINER" --destination-blob "data_source"

注：$SRC_BLOB_URI需替换为源文件的完整Blob地址，可通过az storage blob show命令获取。

验证方式 #

执行完成后，通过以下命令确认文件与虚拟目录是否共存：

az storage blob list --container-name "$DEST_CONTAINER" --output table

输出结果中会同时显示名为data_source的Blob文件，以及以data_source/为前缀的目录下的所有Blob。

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