mihon 中文文档 下载 App

常见故障排查 — 扩展挂了、背景更新不跑、封面模糊等

故障排查总览

出问题了?
    │
    ├─▶ 是扩展的问题?→ [扩展排障指南](troubleshoot-extension.html)
    │
    ├─▶ 是追踪器的问题?→ [追踪 FAQ](tracker-faq.html)
    │
    ├─▶ 是备份恢复的问题?→ [备份包含与排除](backup-content-excluded.html)
    │
    └─▶ 下面是 App 本体和系统层的常见问题 ↓

背景库更新不跑

情况

你触发了全局更新,但更新进度条不动、或只更新了几部漫画就停了。

排查步骤

  1. 电池优化限制(最常见原因):

MIUI、ColorOS、OneUI 等 ROM 的电池优化非常激进,会杀掉后台 App。解决:

  1. 智能更新筛选:

Mihon 默认的智能更新会跳过不符合条件的漫画(没开始读、已完结、有未读章节等)。如果全部跳过了,看起来就是"更新没跑"。可以临时关闭智能更新试试。

  1. 网络问题:

确认手机网络正常,能在浏览器里打开漫画源网站。

  1. Wi-Fi 和移动数据切换:

如果设置了"仅 Wi-Fi 下载/更新",在移动数据下不会更新。

封面模糊 / 损坏 / 空白

情况

书架上的漫画封面看起来很糊、显示不出来、或有损坏。

解决

  1. 刷新封面:
  1. 手动换封面:
  1. 清理缓存:
  1. 检查漫画源:有些漫画源本身的封面就质量差,换个源可能封面清晰些。

章节被标记为未读(没碰过)

情况

某部漫画的章节自己变成"未读"状态,你没改过。

原因

漫画源可能换了章节 URL——Mihon 检测到 URL 变化后,会把它当成新章节重新标记为未读。

这是正常行为,不是 bug。去漫画详情页手动标记一下就行。

全局更新警告

情况

Mihon 在你触发批量更新或批量下载时弹出警告:"频繁请求可能触发漫画源的反爬机制"。

为什么会警告

漫画源不喜欢被爬虫刷爆服务器。Mihon 主动提醒你不要一次性刷太多,是为了保护漫画源(间接也是保护自己——源站被墙或限流后大家都用不了)。

降低警告频率

大量未读章节怎么办

如果书架里突然冒出几百部漫画都有未读章节:

  1. 智能更新应该自动跳过没读完的漫画——如果没跳过,检查智能更新设置
  2. 手动标记已读:长按漫画封面 → 多选 → 批量标记已读
  3. 检查是不是某个源突然加了一堆翻译章节(比如漫画从另一个源迁移过来)

版本号不一致

情况

Mihon 显示自己是 v0.20.x,但 mihonapp.com 显示的版本号(v0.19.9)比 GitHub 上的旧。

不用管。不同渠道的信息更新可能有延迟。以 GitHub Releases 和 Mihon App 内的更新提示为准。

崩溃 / 闪退

App 突然崩溃可能的原因:

可能原因解决
Preview/Nightly 版本身不稳定换 Stable 版
数据库损坏清理应用数据后恢复备份
Android 系统版本太旧更新 Android 系统
特定漫画源扩展 bug卸载那个扩展等更新
手机存储满了释放空间

重置所有设置

如果改乱了设置想回到默认:

  1. 更多 → 设置 → 高级 → 重置设置(Reset settings)
  2. 不会删书架和历史,只恢复设置项默认值

清除应用数据(最后手段)

如果 App 完全打不开、持续崩溃:

  1. 确保有有效备份 → 这步会清掉所有本地数据
  2. 系统设置 → 应用 → Mihon → 清除数据
  3. 重新打开 Mihon → 完成初始设置向导
  4. 恢复备份

寻求帮助

还是解决不了?试试:

本章小结

排查问题先按故障分类:扩展问题跳扩展排障、追踪器问题跳追踪 FAQ、备份问题跳备份页面。App 本体常见问题按高频排序:后台更新不跑(电池优化)> 封面模糊(刷新封面)> 全局更新警告(减少批量操作)> 崩溃(换 Stable 或清数据恢复备份)。最后手段是清应用数据 + 恢复备份——这就是为什么要开自动备份。