使用AzCopy同步Azure Blob容器时扫描到0个文件的问题排查

1. 验证服务主体权限有效性 #

• 确认Storage Blob Data Contributor角色已正确分配至源存储账户/容器，而非仅目标端。角色分配可能存在延迟，若刚分配需等待数分钟生效。
• 用Azure CLI测试服务主体能否读取源容器内容：

  # 以服务主体身份登录
  az login --service-principal -u $AZCOPY_SPA_APPLICATION_ID -p $AZCOPY_SPA_SECRET --tenant $AZCOPY_TENANT_ID
  # 列出源容器内的Blob
  az storage blob list --account-name sourcestoragetest103 --container-name testcontainer --output table
  

  若无法列出Blob，说明权限配置存在问题，需重新检查角色分配范围与对象。

2. 调整AzCopy同步路径参数 #

• 日志提示doesn't have full folder support，说明源存储账户未启用分层命名空间（ADLS Gen2），此时“目录”为Blob前缀形式。需确保源URL明确扫描所有前缀，可在源容器URL后添加/*：

  azcopy sync "https://sourcestoragetest103.blob.core.windows.net/testcontainer/*" "https://destinationstoragetest103.blob.core.windows.net/testcontainer" --recursive=true --delete-destination=true --check-md5
  

3. 检查AzCopy版本兼容性 #

• 旧版本AzCopy对虚拟目录扫描可能存在逻辑缺陷，运行azcopy --version查看当前版本，建议升级至最新稳定版：

  # Linux环境升级命令
  wget https://aka.ms/downloadazcopy-v10-linux && tar -xvf downloadazcopy-v10-linux && sudo cp ./azcopy_linux_amd64_*/azcopy /usr/bin/
  

4. 查看详细日志定位问题 #

• 打开日志文件/home/userme/.azcopy/59fac848-bde6-864a-4c9c-c96ad46711c9.log，检查是否存在权限拒绝、路径无效等未在摘要中显示的细节信息。

5. 确认源容器实际内容 #

• 通过Azure门户或Storage Explorer直接查看源容器testcontainer，确认存在实际CSV文件（而非仅空虚拟目录），空前缀的虚拟目录不会被AzCopy识别为有效内容。

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