Azure文件共享无法删除文件：如何排查SMB锁定并删除文件？

排查隐藏锁定源的方法 #

• 登录Azure门户，进入目标存储账户→文件共享→指标面板，查看Active Connections指标，确认是否存在未断开的后台连接（比如设备休眠唤醒后残留的连接、服务账户发起的连接，这类连接常规重启设备无法清除）。
• 开启存储账户的诊断日志（选择File日志类别），过滤该文件的操作记录，通过日志里的客户端IP、访问账户信息定位锁定源。
• 检查服务器上的后台服务、自动化脚本（比如备份工具、同步程序），尤其是使用系统账户运行的程序，这类连接往往不会在az storage file handle list或PowerShell的句柄查询命令中显示。

强制解锁并删除文件的实操步骤 #

• 删除关联快照：如果目标文件存在快照，快照会锁定原文件。进入存储账户→文件共享→找到对应文件右键查看快照，删除所有关联快照后再尝试删除原文件。
• 强制断开所有共享连接：
  1. 用az CLI获取存储账户连接字符串：

     az storage account show-connection-string --name <你的存储账户名> --resource-group <资源组名>
     

  2. Windows环境：打开管理员命令提示符，执行net use * /delete /y清除所有映射的共享，重新映射后再尝试删除文件。
  3. Linux环境：如果已挂载共享，执行umount /mnt/你的挂载点断开挂载，重新挂载后再操作删除。
• 修改文件属性解除锁定：通过az CLI修改文件元数据强制解除锁定状态，再执行删除：

  az storage file update --account-name <存储账户名> --account-key <存储账户密钥> --share-name <共享名> --path <文件路径> --metadata "locked=false"
  

  接着执行删除命令：

  az storage file delete --account-name <存储账户名> --account-key <存储账户密钥> --share-name <共享名> --path <文件路径>
  

后续预防建议 #

• 确保客户端程序正常关闭文件，避免强制退出导致的残留锁定。
• 针对长期运行的服务，配置定期断开重连的机制，防止连接泄漏引发锁定问题。

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