TagSpaces搜索功能异常排查与解决方案

问题现象分析

在TagSpaces v6.0.0版本中，当用户启用"在独立进程中生成缩略图和搜索索引"功能时，会出现搜索失败并提示"Search failed. No Index"的错误。而禁用该选项后，搜索功能则恢复正常工作。该问题在Windows 11系统下的TagSpaces Lite版本中表现明显。

技术背景

TagSpaces的搜索功能采用了两种工作模式：

1. 主进程模式：所有索引和搜索操作都在主Electron进程中完成
2. 独立进程模式：通过WebSocket服务在独立进程中处理索引任务

问题根源

通过日志分析发现，当启用独立进程模式时，系统尝试连接WebSocket服务时出现URL解析错误，具体表现为尝试连接http://127.0.0.1:undefined地址。这表明端口号参数未能正确传递，导致WebSocket服务无法建立连接。

解决方案验证

经过测试确认：

1. 临时解决方案：在设置中禁用"在独立进程中生成缩略图和搜索索引"选项
2. 永久解决方案：升级到TagSpaces v6.0.2版本后问题得到修复

技术建议

对于开发者而言，需要注意：

1. 进程间通信参数的完整性验证
2. WebSocket服务的端口动态分配机制
3. 错误处理逻辑的完善性

对于用户而言，建议：

1. 检查系统防火墙设置是否阻止了本地回环通信
2. 确保使用最新版本的TagSpaces
3. 在Linux系统中，优先使用官方提供的安装包而非第三方打包版本

版本兼容性说明

该问题主要影响v6.0.0版本，在后续版本中已得到修复。不同系统环境下的表现可能有所差异，Windows系统用户更易遇到此问题，而Linux用户在使用官方打包版本时问题较少出现。