Remotely-Save插件WebDAV同步URI不匹配问题分析与解决方案

问题背景

在使用Remotely-Save插件进行WebDAV同步时，部分用户遇到了400错误请求的问题。该问题主要出现在使用Apache WebDAV服务器并启用摘要认证(Digest Auth)的场景下，而基本认证(Basic Auth)则工作正常。

错误现象

当用户尝试同步包含新文件夹的Vault时，插件能够成功创建Vault根目录，但在创建子文件夹时会失败。Apache错误日志中会显示如下信息：

uri mismatch - </webdav/name-vault> does not match request-uri </webdav/name-vault/>

技术分析

根本原因

该问题源于URI末尾斜杠的处理不一致性。在WebDAV协议实现中，特别是Apache的摘要认证模块(auth_digest)对URI的匹配非常严格。当请求URI与认证URI存在斜杠差异时，摘要认证会拒绝请求。

认证机制差异

• 基本认证(Basic Auth)：以Base64编码方式传输凭证，不验证URI一致性
• 摘要认证(Digest Auth)：使用挑战-响应机制，会验证请求URI与原始认证URI的一致性

影响范围

该问题主要影响：

1. 使用Apache WebDAV服务器的用户
2. 启用了摘要认证的环境
3. 首次同步或创建新文件夹时的场景

解决方案

临时解决方案

1. 改用基本认证：在WebDAV服务器和Remotely-Save插件中都配置使用基本认证
2. 确保HTTPS：使用有效的HTTPS证书可提高安全性，弥补基本认证的不足

永久解决方案

Remotely-Save开发团队已在最新版本(0.4.16之后)中修复了此问题。修复内容包括：

1. 统一URI格式处理，确保请求URI与认证URI的一致性
2. 优化斜杠处理逻辑，避免因URI格式差异导致的认证失败

最佳实践建议

1. 认证方式选择：除非有特殊安全需求，建议使用基本认证
2. 协议选择：始终使用HTTPS协议保护数据传输
3. 版本更新：保持Remotely-Save插件为最新版本
4. 服务器配置：检查WebDAV服务器日志，确保没有其他配置问题

总结

URI匹配问题是WebDAV协议实现中常见的边缘情况。Remotely-Save团队通过修复URI处理逻辑，解决了这一同步问题。用户可通过更新插件或调整认证方式来获得稳定的同步体验。对于自建WebDAV服务的用户，建议同时检查服务器配置，确保与客户端的兼容性。