OneDrive Linux客户端同步SharePoint文档库根目录文件夹删除问题分析

问题背景

在Linux环境下使用abraunegg/onedrive客户端同步SharePoint文档库内容时，发现一个关键问题：当用户通过"添加到OneDrive"功能将SharePoint文档库链接到个人OneDrive后，文档库根目录下的空文件夹或包含OneNote笔记本的文件夹会在同步过程中被意外删除。

问题现象

具体表现为：

1. 在SharePoint文档库中创建空文件夹或包含OneNote笔记本的文件夹
2. 通过"添加到OneDrive"功能将文档库链接到个人OneDrive
3. 配置客户端启用共享文件夹同步选项
4. 执行同步操作后，发现上述文件夹从在线SharePoint文档库中被删除

技术分析

经过深入排查，发现问题根源在于客户端代码中对共享文件夹项目的处理逻辑存在缺陷。在同步过程中，客户端错误地将SharePoint文档库根目录下的文件夹识别为需要删除的项目。

关键问题代码位于src/sync.d文件中，当处理共享文件夹项目时，使用了错误的项目ID进行数据库查询，导致无法正确识别文件夹类型和状态。

解决方案

开发团队通过以下修改解决了该问题：

1. 修正数据库查询逻辑，确保使用正确的项目ID进行查询
2. 完善文件夹类型识别机制，避免误判为需要删除的项目
3. 增强对SharePoint文档库根目录特殊情况的处理

修复后的版本(v2.5.5-9-g171b89b)经过测试验证，能够正确处理以下场景：

• 本地创建的文件夹结构
• 来自其他用户账户的共享文件夹
• SharePoint文档库根目录的共享内容

技术细节

该问题特别影响通过"添加到OneDrive"功能链接的SharePoint文档库根目录内容，与普通用户间共享文件夹的行为有所不同。修复方案确保了：

1. 空文件夹能够正确保留
2. 包含OneNote笔记本的文件夹不会被误删
3. 嵌套文件夹结构保持完整
4. 各种特殊字符命名的文件夹同步正常

用户建议

对于遇到类似问题的用户，建议：

1. 升级到包含修复的客户端版本
2. 在执行重要同步操作前进行备份
3. 注意区分普通共享文件夹和SharePoint文档库链接的不同行为
4. 对于关键业务数据，建议先在测试环境验证同步行为

该修复不仅解决了文件夹被意外删除的问题，也为Linux环境下OneDrive客户端与SharePoint文档库的集成提供了更可靠的同步体验。