ADF复制活动遇AzureFileLeaseConflictError报错，寻求解决方法

问题场景 #

配置ADF复制活动递归复制文件夹内XML文件至目标文件夹，完成后删除源文件时执行失败，报错信息如下：

Error code: AzureFileLeaseConflictError
Failure type: User configuration issue
Details:
ErrorCode=AzureFileLeaseConflictError,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=AzureFile lease has been acquired or not been released by other jobs. Path:path/to/file.xml,
Source=Microsoft.DataTransfer.ClientLibrary,''Type=Microsoft.Azure.Storage.StorageException,Message=The specified resource may be in use by an SMB client.,Source=Microsoft.Azure.Storage.Common,'

排查与解决方法 #

• 检查SMB客户端占用：确认源文件所在的Azure文件共享是否被其他SMB客户端挂载或访问（比如本地机器映射了共享、服务器进程正在读写文件），必须断开所有SMB连接后重试活动。
• 降低复制并发数：在复制活动的「设置」选项卡中调低并发数，避免批量操作时多个进程同时抢占文件租赁导致冲突。
• 增加删除延迟：在复制活动后添加「等待活动」，设置3-5秒延迟，确保复制完成后文件租赁完全释放，再执行删除操作。
• 排查其他作业占用：检查同一存储账户下是否有其他ADF作业、逻辑应用或Azure函数正在操作这批XML文件，导致租赁被占用。
• 检测文件租赁状态：用Azure存储资源管理器查看文件租赁信息，或通过Azure CLI命令查询：

  az storage file show --account-name <你的存储账户名> --share-name <文件共享名> --path <目标文件路径> --query 'lease'
  

  确认文件是否被租赁及持有者，针对性释放或终止占用进程。

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