Immich项目外部库资产离线问题分析与解决方案

问题背景

Immich是一款自托管的照片备份服务，在1.130.0版本更新后，用户报告了一个严重问题：当使用多个导入路径时，外部库中的资产会周期性地从时间线中消失，大约每半小时发生一次。这个问题影响了服务器、网页端和移动端的所有平台。

问题现象

受影响用户观察到以下典型症状：

1. 时间线内容周期性清空
2. 手动重新扫描外部库后，照片会立即重新出现
3. 约30分钟后问题再次出现
4. 问题与默认的排除模式无关（如**/@eaDir/和**/._*）

技术分析

经过开发团队深入调查，发现问题根源在于SQL查询逻辑中的一个布尔逻辑错误。具体来说：

1. 代码中使用了错误的布尔运算符组合来处理多个导入路径
2. 开发者在编写查询条件时，错误地应用了德摩根定律(De Morgan's Laws)
3. 原始查询语句为：

   eb.or([
     eb('originalPath', 'not like', paths.join('|')),
     eb('originalPath', 'like', exclusions.join('|'))
   ])
   

4. 问题出在对导入路径使用"not like"操作符时，实际上是在查询"该路径是否存在于所有导入路径中"，而正确的逻辑应该是"该路径是否存在于任何导入路径中"

德摩根定律的应用

德摩根定律是布尔代数中的重要定律，它说明了逻辑与和逻辑或运算之间的对偶关系。在本案例中：

• 开发者需要将"不属于所有路径"转换为"不属于任何路径"
• 正确的转换应该考虑运算符的优先级和逻辑关系
• 最终解决方案是调整查询逻辑，确保正确地表达"存在于任何导入路径"的条件

解决方案

开发团队已经提交修复代码，主要修改包括：

1. 修正导入路径的查询逻辑
2. 确保排除模式正确处理
3. 优化多路径情况下的资产扫描流程

临时应对措施

在官方修复发布前，用户可以采取以下临时措施：

1. 减少外部库扫描频率
2. 暂时合并多个导入路径为单一路径
3. 定期手动触发库扫描

经验总结

这个案例展示了：

1. 布尔逻辑在数据库查询中的重要性
2. 德摩根定律在实际编程中的应用价值
3. 多路径处理时需要特别注意的逻辑边界条件
4. 自动化测试在文件系统操作中的必要性

结论

Immich团队迅速响应并解决了这个影响用户体验的关键问题。该案例不仅展示了开源社区的高效协作，也为开发者提供了关于布尔逻辑和文件系统查询的宝贵经验。用户只需等待下一个版本更新即可获得永久修复。