Azure Files LIST事务量过高求助：成因分析与规避方案

一、LIST事务的具体定义 #

除了官网提到的“枚举文件共享内的文件和目录的操作”，实际触发场景更具体：

• 任何调用Azure Files ListFilesAndDirectories API的操作都算一次LIST事务，包括手动在资源管理器打开目录、递归遍历子目录（每进入一层子目录就会触发一次API调用）
• 系统或应用的自动操作：Windows资源管理器的缩略图生成、文件索引服务的定期扫描、杀毒软件的实时监控、Azure File Sync的目录同步检查、第三方备份工具的目录遍历，甚至某些应用启动时的文件路径检测，都会触发LIST事务
• 大目录下的LIST操作会因为API分页返回，每一页结果对应一次LIST事务，比如一个有1000个文件的目录，单次LIST可能返回200条，就会产生5次LIST事务

二、减少LIST事务的实用方案 #

• 优化客户端系统设置
  • 关闭Windows资源管理器的「自动刷新」和「缩略图预览」：大目录下预览会强制枚举所有文件生成缩略图，触发大量LIST事务；在资源管理器选项中禁用“在文件夹中显示缩略图而非图标”，并关闭“自动刷新”
  • 排除杀毒软件/安全工具的扫描：将Azure Files共享目录加入杀毒软件的排除列表，避免实时扫描或高频定期扫描触发目录枚举
  • 禁用文件索引服务：在Windows索引选项中移除Azure Files共享，索引服务会定期遍历目录更新索引，产生大量LIST事务
• 调整Azure Files同步策略
  • 优化Azure File Sync的云分层与同步间隔：延长同步检查的间隔时间（避免短时间内重复触发目录同步），调整云分层的缓存规则，只缓存常用文件，减少本地与云端的目录比对次数
  • 避免使用高频遍历目录的工具：比如某些传统备份软件，改用Azure原生的备份工具，这类工具针对云存储做了优化，减少不必要的LIST操作
• 重构目录结构
  • 扁平化目录层级：减少深层嵌套的子目录，每一层子目录的访问都会触发一次LIST事务，层级越深，事务量越高
  • 合并小文件：将大量小文件打包成压缩包或合并为单个文件，减少目录内的文件数量，避免LIST操作因分页返回产生多次事务
• 定位触发源并针对性优化
  • 用Azure Monitor监控：筛选Transaction指标中的List类型，结合活动日志查看触发事务的客户端IP或操作来源
  • 用Process Monitor抓包：在测试客户端运行Process Monitor，过滤目标Azure Files共享的访问记录，找出频繁触发目录枚举的进程（比如某些后台服务、第三方应用），直接禁用或调整其行为

三、能否完全规避LIST事务？ #

无法完全规避。即使无人操作，Azure自身的后台健康检查、Azure File Sync的心跳检测、客户端系统的某些后台服务（如网络连接状态检查）仍会产生少量LIST事务，但通过上述优化方案，可以将事务量降低到可忽略的水平，避免产生高额成本。

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