Stylus插件WebDAV同步失败问题排查与解决方案

问题背景

Stylus作为一款流行的浏览器样式管理插件，提供了通过WebDAV协议进行数据同步的功能。然而在实际使用中，部分用户反馈无法成功完成WebDAV同步操作，主要表现为持续显示"Failed to fetch"或"Syncing..."状态，而实际上服务器端仅生成了一个名为"lock.json"的空文件。

问题现象分析

经过深入调查，我们发现该问题主要出现在使用群晖NAS等自建WebDAV服务的场景中。典型症状包括：

1. 同步操作无法完成，界面显示错误提示
2. WebDAV目录下仅生成lock.json文件，内容为过期时间戳
3. 使用其他WebDAV客户端（如Tampermonkey插件）却能正常工作
4. 开发者工具网络面板中看不到与WebDAV服务器的通信记录

根本原因

问题的核心在于WebDAV服务器权限配置不当。具体来说：

Stylus在同步过程中会尝试自动创建两个子目录：

• docs目录：用于存储样式文件
• changes目录：用于记录变更历史

当WebDAV账户没有在这些目录上创建子目录的权限时，服务器会返回403 Forbidden错误，导致同步流程中断。由于浏览器扩展的网络请求在开发者工具中默认不可见，这增加了排查难度。

解决方案

临时解决方法

1. 手动在WebDAV根目录下创建两个子目录：
   • docs
   • changes
2. 确保WebDAV账户对这些目录有读写权限
3. 在Stylus设置中重新连接WebDAV服务

永久解决方案

1. 登录WebDAV服务器管理界面（如群晖NAS的DSM系统）
2. 找到WebDAV服务设置
3. 为使用的账户分配以下权限：
   • 根目录的读写权限
   • 创建子目录的权限
4. 保存设置并重启WebDAV服务（如需要）

技术细节补充

WebDAV协议本身支持MKCOL（创建集合/目录）操作，这是Stylus用来创建子目录的方法。当服务器配置不当或权限不足时，这类操作会失败。lock.json文件是Stylus用于实现同步锁机制而创建的，它的存在表明插件已经能够与服务器建立基本连接，但在后续操作中遇到了权限问题。

最佳实践建议

1. 为Stylus创建专用的WebDAV账户，而非使用管理员账户
2. 限制该账户只能访问特定目录
3. 预先创建好docs和changes目录并设置适当权限
4. 定期检查同步日志，确保操作正常

总结

WebDAV同步问题通常源于权限配置而非插件本身缺陷。通过正确配置服务器权限或预先创建所需目录，大多数用户都能解决同步失败的问题。对于自托管WebDAV服务的用户，建议参考服务器文档详细了解权限管理机制，以确保Stylus等客户端能够正常工作。