Folo 报错了10 分钟恢复使用的故障排查清单【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/followFolo 是一个 AI RSS 阅读器把订阅源、播客和社交动态汇聚到一条时间线。当你遇到安装被拦截、启动闪退、登录掉线或内容不更新时不用翻代码——本文按装不上 → 跑不起来 → 用起来异常 → 数据/网络 → 升级求助的时间线每个场景独立成卡你可以直接跳到对应的卡片照着做。30 秒分诊先看症状找到入口你看到的症状第一处置动作Windows 弹出无法验证发布者装不上不是病毒确认安装包来自官方渠道后选择仍要运行macOS 点开即退出或登录后卡在加载把版本升到 1.5.0 或更高刚登录就掉线反复重新登录检查 1.7.0 的修复记录多端别用同一账号同时登录添加订阅源提示无效 URL或连接失败先用浏览器打开同一个 URL 验证时间线长时间不出现新内容手动刷新一次观察是否超时自动更新失败或卡住关闭应用手动下载安装包覆盖安装1. 安装时系统直接拦截SmartScreen 或 Gatekeeper 警告现象Windows 弹出已保护你的电脑 / 无法验证发布者macOS 提示已损坏或不响应。最可能原因Folo Windows 版使用的是 SignPath.io 免费代码签名官方说明见 README.md 的 Code signing policy 一节不是大型厂商证书系统对陌生发行者的默认反应就是拦截。这是预期行为不是安装包损坏。处理步骤先确认文件来自 Folo 官方下载渠道而不是第三方转载站。Windows在弹窗中选更多信息 → 仍要运行若安装程序提示发布者不可验证右键安装包 → 属性 → 勾选解除锁定 → 以管理员身份运行。macOS系统设置 → 隐私与安全性页面底部会出现仍要打开选项点击并输入密码。如果还不行换一个浏览器重新下载安装包再走一遍上面流程。仍被拦截的话截图弹窗原文走文末的求助渠道。2. 启动即退出或登录后卡住不动现象点图标没反应、窗口一闪而过或者登录页能进、登录成功后一直转圈。最可能原因旧版本的登录会话刷新机制有缺陷——cookie 更新后会话刷新失败API 请求超时也偏短。这些在 1.5.0 和 1.7.0 已修记录见 apps/desktop/changelog/1.5.0.mdFixed auth origin headers and restored renderer API requests和 apps/desktop/changelog/1.7.0.mdExtended API request timeouts。处理步骤先打开设置 → 关于看当前版本号。低于 1.7.0 就升级——注意先解决卡片 6 的更新失败问题。升级后彻底退出应用重新打开登录一次确认能进入时间线。如果还不行手动清掉缓存目录再启动。macOS打开终端执行rm -rf ~/Library/Caches/is.followWindows一般可以试试删除%LOCALAPPDATA%\Folo下的缓存文件夹先退出应用。清完重新登录。3. 刚登录就掉线反复重新登录现象会话在几分钟内反复失效桌面端尤甚有时切个页面就要求重新登录。最可能原因多端挤占会话。同一账号在网页端、桌面端、手机端同时活跃时cookie 相互覆盖旧版本没有处理好这个生命周期——这正是 1.5.0 修复的Hardened setting sync authentication lifecycle和 1.7.0 修复的Fixed duplicate desktop auth session cookies针对的问题。处理步骤先把所有设备退出登录只保留一台。在保留的那台重新登录正常刷 5 分钟时间线观察是否再次掉线。如果还不行清一次本地会话卡片 2 的清缓存命令再登录。若问题复现说明可能是服务端会话问题记录掉线发生的时间点和设备走求助渠道。4. 添加订阅源无效 URL 或连接失败现象粘贴 RSS 链接后提示 URL 无效、解析失败或连接超时同一个 URL 在浏览器里看着没问题。最可能原因分两种。URL 本身不合法缺协议头、含特殊字符或源端要求登录、有反爬限制。Folo 对非法 URL 有专门的解析防护见 apps/desktop/changelog/1.3.0.md 的Fix handle invalid URL parsing所以提示无效时它通常没有说谎。处理步骤先把 URL 贴进浏览器回车。打不开或跳登录页 → 问题在源端换 RSSHub 托管的对应源这不是 Folo 的锅。浏览器能打开但 Folo 加不上 → 检查 URL 是否以http://或https://开头去掉末尾多余空格。重新粘贴添加这次应能看到订阅成功、列表里出现新源。如果还不行在发现页用 RSSHub 入口搜索同主题内容先订阅 RSSHub 源验证 Folo 侧订阅链路正常再回头排查原源。5. 时间线不更新或刷新一直转圈现象源明明有新文章Folo 迟迟不显示手动刷新后长时间无响应。最可能原因网络不稳定触发 API 请求超时或你刚添加了大量源、源端在限流。判断依据很简单刷新按钮转圈超过 30 秒还不返回基本就是超时。处理步骤先手动点一次刷新观察是否 10 秒内出现新条目。若持续超时检查当前网络换个 Wi-Fi 或切换 4G/5G 验证排除本地网络抖动。若刚批量添加过订阅源等 10 分钟再刷新给源端一点时间。如果还不行确认版本不低于 1.7.0超时时间在该版本延长过仍超时则记录刷新等待时长和网络环境提交反馈。6. 更新失败版本号死活不涨现象提示有更新但下载卡住Windows 上更新检查本身不触发更新完打开还是旧版本。最可能原因这两个都是历史已知 bug。Windows EXE 的更新检查失效在 1.1.0 修复过见 apps/desktop/changelog/1.1.0.md桌面端 OTA 更新回归在 1.6.x 修复说明更新链路本身有过不稳定期。处理步骤完全退出应用Windows 注意托盘里的 Folo 图标也要退出。从官方下载页拿对应系统、对应架构的最新安装包。直接运行安装包覆盖安装启动后到设置 → 关于核对版本号与下载页一致。如果还不行手动安装也失败时记下安装包文件名和报错原文——这多半是下载文件损坏重新下载一次通常就好。7. iOS 端打开闪退或启动后加载失败现象点图标闪退或启动后一直停在加载页。最可能原因旧版本有 SQLite 本地数据库启动崩溃问题0.3.0 已修复Fixed iOS SQLite startup crash见 apps/mobile/changelog/0.3.0.md。还在闪退基本等于版本太旧。处理步骤App Store 里把 Folo 升到最新版支持后台 OTA 更新升级路径见 apps/ota/ 的说明。强制关闭应用上滑清除后重新打开应能正常进入首页。如果还不行卸载重装前先记下 iOS 版本号、Folo 版本号和闪退发生时间若重装仍闪退这些是 Issue 里最需要的信息。自检清单版本号已核对且为当前最新稳定版同一账号没有在多个设备同时登录订阅 URL 在浏览器中可正常打开刷新时间线能在 10~30 秒内返回应用从官方渠道安装非第三方转载求助前准备好这些信息提交 Issue 或反馈时附上客户端类型桌面/网页/移动 版本号 操作系统版本 报错截图或弹窗原文 复现步骤。另外说明一点仓库里的 scripts/run-proxy.sh 是开发者用 mitmproxy 调试app.folo.is的本地脚本不是给终端用户的修复工具排查时不要跑它。带上以上信息再描述现象开发者能直接定位到你卡住的那一步而不是先问你什么版本。【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/follow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考