DAVx5项目中WebDAV ETag缓存失效问题的分析与解决

背景介绍

在WebDAV协议实现中，ETag作为资源标识符对缓存机制至关重要。近期在DAVx5项目中发现了一个关于ETag缓存处理的缺陷：当服务器资源变更后，客户端仍使用旧ETag发起条件请求，导致412 Precondition Failed错误，且未能自动更新本地缓存。

问题现象

用户在使用DAVx5访问WebDAV服务器时，若发生以下操作序列：

1. 客户端首次获取文件并缓存ETag
2. 服务端文件被第三方修改
3. 客户端使用旧ETag发起带If-Match头的GET请求
4. 服务端返回412状态码及新ETag
5. 客户端仍持续使用旧ETag，造成持续访问失败

技术分析

通过抓包分析可见问题本质：

• 客户端请求携带过期ETag："2d-62884a9c76e03"
• 服务端响应412并返回新ETag："33-62884ac7ecd5a"
• 现有实现未处理响应中的新ETag，也未触发缓存更新

解决方案

开发团队经过讨论确定了两种改进方向：

1. 即时更新机制：在收到412响应时，提取响应头中的新ETag更新本地缓存
2. 保守更新策略：完全放弃HEAD响应缓存，改为每次操作前强制HEAD请求获取最新ETag

最终采用了更可靠的第二种方案，因为：

• 消除缓存不一致的根本原因
• 符合WebDAV协议对强一致性的要求
• 虽然增加少量网络开销，但保证数据准确性

实现效果

修复后：

1. 每次文件操作前执行HEAD请求获取最新ETag
2. 确保后续请求使用正确的条件头
3. 当检测到服务端资源变更时，立即更新本地状态
4. 彻底避免因缓存过期导致的412错误循环

技术启示

该案例揭示了分布式系统中缓存一致性的典型挑战。在移动端实现WebDAV协议时，需要特别注意：

• 网络不稳定性可能加剧缓存问题
• 移动设备资源限制要求平衡性能与正确性
• 条件请求的正确处理是WebDAV实现的核心

此修复现已合并到DAVx5主分支，显著提升了客户端在文件并发修改场景下的可靠性。