Syncthing-Android项目中文件重命名导致意外删除的问题分析

问题背景

在Syncthing-Android项目中，用户报告了一个严重的文件同步问题：当用户将文件名中的下划线(_)改为连字符(-)时，Android客户端会错误地将该文件从所有同步设备中删除。这个行为不仅影响了用户体验，还可能导致重要数据丢失。

问题复现与验证

通过详细测试，我们确认了该问题的复现步骤：

1. 在PC端创建名为"test_file.txt"的文件
2. 等待文件同步到Android设备
3. 将文件名修改为"test-file.txt"
4. 观察发现Android设备会删除该文件，并将删除操作同步回PC端

测试过程中，我们观察到文件同步状态显示为"已删除"，而实际上用户只是进行了简单的重命名操作。

技术原因分析

经过代码审查，我们发现问题的根源在于事件处理器(EventProcessor)中的SQL查询逻辑。在比较文件名时，代码使用了SQL的LIKE操作符而不是精确匹配(=)。LIKE操作符在某些SQLite实现中会将下划线和连字符视为等效字符，导致系统错误地将重命名操作识别为文件删除。

具体来说，当文件名从"test_file.txt"改为"test-file.txt"时，系统错误地认为原文件已不存在，从而触发了删除操作，而非正确的重命名同步。

解决方案实现

针对这个问题，我们实施了以下修复措施：

1. 将文件名比较逻辑从LIKE操作符改为精确匹配(=)
2. 确保所有文件名比较操作都严格区分下划线和连字符
3. 添加了额外的验证逻辑来区分真正的删除操作和重命名操作

这个修复确保了文件重命名操作能够被正确识别和同步，而不会意外触发删除流程。

对用户的影响与建议

对于使用Syncthing-Android进行文件同步的用户，我们建议：

1. 及时更新到包含此修复的版本
2. 在重命名文件时，特别是涉及特殊字符变化时，先进行小范围测试
3. 定期备份重要文件，以防同步过程中出现意外情况

总结

文件同步软件中的重命名处理是一个需要特别关注的敏感操作。Syncthing-Android项目通过这次修复，改进了文件名变更的识别逻辑，提高了同步的可靠性。这也提醒我们，在开发跨平台文件同步解决方案时，需要特别注意不同操作系统和数据库实现对于特殊字符的处理差异。