Remotely-Save插件WebDAV同步中的文件夹创建顺序问题解析

在文件同步系统中，文件夹创建顺序与文件传输的先后关系是一个需要特别注意的技术细节。近期在Remotely-Save插件（版本0.3.37）中发现了一个典型的同步逻辑缺陷，该问题在使用WebDAV协议（如NextCloud）进行同步时尤为明显。

问题现象

当用户尝试手动同步包含非空文件夹的Vault时，如果设置并发连接数为1（通常用于匹配服务器端配置），系统会先尝试同步嵌套在文件夹内的文件，而非优先创建父级文件夹结构。这导致系统在父目录尚未建立的情况下尝试传输文件，最终触发404错误（资源未找到）。

技术原理

1. WebDAV协议特性：WebDAV作为HTTP的扩展协议，要求目标路径必须存在才能进行文件上传。这与某些本地文件系统自动创建路径的特性不同。

2. 同步逻辑缺陷：插件在低并发模式下（concurrency=1）未实现文件夹优先创建的策略，导致文件传输顺序与路径依赖关系不匹配。

3. 两种规避方案：

   • 预先同步空文件夹结构
   • 提高并发数（允许并行创建文件夹和文件）

解决方案

开发团队在0.3.38版本中修复了该问题，主要改进包括：

1. 同步顺序优化：确保在任何文件传输前，其所在路径的文件夹结构已完整建立。

2. 错误处理增强：增加对路径不存在情况的预处理，提供更友好的错误提示。

最佳实践建议

1. 对于严格限制并发数的环境，建议先同步基础文件夹结构。

2. 定期更新插件版本以获取稳定性改进。

3. 复杂目录结构同步时，可考虑分批次进行。

这个案例典型地展示了分布式系统中"顺序保证"的重要性，也为其他文件同步工具的开发提供了有价值的参考。同步工具必须充分考虑目标存储系统的特性，才能确保数据传输的可靠性。