TypeError: tmpl.connectors is not iterable

TypeError: tmpl.connectors is not iterable

快速结论：该报错出现在 LobeChat 桌面客户端（Electron）自动从 2.2.6 升级到 2.2.7 后，客户端白屏并提示错误。优先排查数据库迁移是否完整，或回退到旧版本。

问题场景

Windows 系统上运行的 LobeChat 桌面客户端（Electron 版，2.2.7 版本），通过客户端提示的自动更新机制从 2.2.6 升级到 2.2.7 后，应用启动时立即崩溃，显示错误页面。用户重装 2.2.6 后恢复正常。

报错原文

ERROR 页面暂时不可用
页面暂时不可用。你可以返回首页，或稍后重试（你的设置不会因此丢失）
TypeError: tmpl.connectors is not iterable

原因分析

该错误来自任务模板推荐模块中对 tmpl.connectors 的遍历。当某个模板数据中的 connectors 字段为 null 或 undefined（而非预期数组）时，就会触发此错误。可能原因如下：

• 升级过程中数据库迁移不完整，旧版本的模板数据缺少 connectors 字段，而 2.2.7 新版本代码直接进行了遍历，没有做空值保护。
• 服务端数据与新版客户端不兼容，导致模板数据格式异常。

环境排查

• 确认客户端版本：LobeChat Desktop 2.2.7
• 确认操作系统：Windows
• 确认部署方式：自托管 Docker + 桌面客户端（Electron）

解决步骤

1. 优先尝试：回退到旧版本。 如 Issue 中用户所示，保留旧版本安装包（如 2.2.6），卸载 2.2.7 后重新安装 2.2.6 即可恢复正常。
2. 若需尝试升级：
   • 在升级前备份 LobeChat 的数据库文件。
   • 升级到 2.2.7 后如果再次出现错误，打开浏览器开发者工具（F12 → Console），获取完整的错误堆栈信息。
   • 将完整错误堆栈提供给开发者，以便定位具体是哪个模板数据存在问题。
3. 注意自动更新机制： 桌面端自动更新近期已有多个修复合入（如 PR #15525），但自动更新本身不应导致数据问题。如果问题持续，建议暂时关闭自动更新。

验证方法

客户端能够正常启动，不再显示错误页面，且能正常加载之前的设置和插件。如果能正常进入首页并使用功能，则问题已解决。

参考来源

lobehub/lobe-chat #16123