扩展加载失败或不显示——5 步排查流程

症状

• 添加了社区仓库但扩展列表一直是空的
• 浏览页点开某个扩展后一直转圈、加载不出来
• 扩展已安装但源站目录加载失败
• 刚更新了扩展，突然就用不了了

第一步：网络问题（最常见）

Keiyoushi 社区仓库托管在 GitHub Raw 上（raw.githubusercontent.com），国内网络可能加载慢或被墙。

测试方法：

1. 用手机浏览器打开仓库 URL（你添加的那个）
2. 能看到一个 JSON 文本 → 网络 OK，问题在 Tachiyomi 侧
3. 浏览器里也打不开 → 网络/代理问题

解决方案：

• 开代理（VPN）再试
• 换 Wi-Fi 或用手机流量
• 试试 GitHub 的镜像加速（jsdelivr 等）

第二步：扩展仓库 URL 问题

仓库 URL 可能写错了，或者 Keiyoushi 换了地址。

正确的 Keiyoushi 仓库地址：

https://raw.githubusercontent.com/keiyoushi/extensions/repo/index.min.json

检查你粘贴的 URL 有没有：

• 多空格
• 少字母（比如 keiyoushi 拼成了 keiyoshi）
• 用了旧地址

仓库地址错了 → 删掉 → 用正确地址重新添加。

第三步：Tachiyomi 版本太旧

Keiyoushi 仓库的格式可能不兼容原版 Tachiyomi 0.15.x 之前的版本。

检查当前版本：更多 → 关于 → 版本号

如果版本在 0.14.x 或更早 → 建议直接迁移到 Mihon 或 TachiyomiSY。原版 0.15.3 终版对 Keiyoushi 仓库的兼容性有时也不稳定。

第四步：WebView 版本问题

Android 的「Android System WebView」组件负责渲染部分源站页面。如果它版本太旧，有些源加载不了。

检查和更新：

1. Android 设置 → 系统 → 系统组件更新
2. 找「Android System WebView」→ 更新到最新版
3. 或在 Google Play 搜「Android System WebView」→ 更新

更新完重启 Tachiyomi 再试。

第五步：清除应用数据

前四步都没解决 → 最后大招：清除 Tachiyomi 应用数据。

⚠️ 先备份！清除应用数据会删除所有书架、设置、下载、追踪绑定！

步骤：

1. 先导出备份文件（更多 → 备份和还原 → 创建备份 → 传到云端）
2. Android 设置 → 应用 → 找到 Tachiyomi → 存储 → 清除数据
3. 重启手机（可选但有帮助）
4. 打开 Tachiyomi → 重新添加仓库 → 还原备份

其他常见场景

扩展安装后还是加载不出

• 扩展本身有问题：去 Keiyoushi 仓库的 Issues 页面看看有没有人报告
• 源站加了 Cloudflare / 反爬：有些扩展作者会在新版本里处理，等更新
• 需要登录才能看：某些源要账号登录 → 在扩展里点「登录」按钮

扩展列表里没有中文漫画源

Keiyoushi 仓库筛选里：扩展页顶部分类筛选 → 语言选「中文」。或者直接搜索（浏览页的搜索功能是跨扩展的）。

继续：02-章节打不开怎么办