Remotely-Save插件在WebDAV服务器上的部分上传问题分析

问题背景

Remotely-Save是一款为Obsidian笔记软件设计的同步插件，支持多种云存储服务。在最新版本0.4.22中，开发者引入了部分上传功能以优化大文件同步体验。然而，这一改动导致部分使用nginx作为WebDAV服务器的用户遇到了同步失败问题。

技术细节

当用户使用nginx的ngx_http_dav_module和nginx-dav-ext-module搭建WebDAV服务器时，插件尝试执行部分上传操作会触发错误。这是因为nginx的WebDAV实现不完全支持HTTP PATCH方法，这是实现部分上传所必需的协议扩展。

在0.4.22版本中，插件会将这些部分上传失败计入错误计数器，当错误累积到一定数量时触发"tooManyErrors"保护机制，导致同步过程中断。而回退到0.4.21版本则能正常工作，因为该版本尚未引入部分上传功能。

解决方案

开发者迅速响应并修复了这一问题。在0.4.23版本中，针对不支持部分上传的WebDAV服务器，插件会进行以下改进：

1. 自动检测服务器能力，对不支持部分上传的服务器禁用该功能
2. 将部分上传失败排除在错误计数器之外，避免触发"tooManyErrors"机制
3. 回退到完整文件上传方式，确保同步功能正常运作

用户建议

对于使用nginx作为WebDAV服务器的Obsidian用户，建议：

1. 立即升级到0.4.23或更高版本
2. 如果暂时无法升级，可手动降级到0.4.21版本
3. 考虑评估其他WebDAV服务器实现（如Nextcloud或SabreDAV）以获得更完整的功能支持

总结

这一案例展示了开源项目中功能迭代与兼容性维护的重要性。Remotely-Save团队通过快速响应和修复，确保了插件在各种环境下的稳定性，同时也提醒用户在自建服务时需要注意协议支持完整性。