下载缓慢或下载失败怎么排查
先确认现象
下载问题分几类，排查方向不同：
| 现象 | 可能方向 |
|---|---|
| 点安装后进度条一动不动 | 后台权限 / 网络连接 / 证书状态 |
| 进度条走到一半停住 | 网络不稳定 / 存储不足 |
| 下载完提示「安装失败」 | 存储不足 / 应用签名问题 |
| Safari 从官方站下载兔兔助手本身就慢 | 官方站 CDN 节点问题 / 网络运营商限制 |
手机端（兔兔助手 App 内）下载慢
检查一：网络连接
- Wi-Fi 信号：信号差的时候下载速度会明显下降。换到信号满格的地方，或者直接切蜂窝网络试；
- 运营商限制：部分移动运营商对第三方应用商店的下载做了限速（尤其是 APP 体积大于 100MB 时）。蜂窝下载特别慢时换 Wi-Fi；
- DNS：如果你的路由器或手机 DNS 解析兔兔助手 CDN 节点有问题，会导致下载走绕路。临时把手机 DNS 改成公共 DNS（如 1.1.1.1 或 8.8.8.8）试试。
检查二：后台下载开关 + 定位权限
兔兔助手的后台下载依赖定位权限（iOS / Android 的后台进程策略要求）。如果下载时切出兔兔助手就断了，检查：
- 兔兔助手设置 → 后台下载开关是否打开；
- 定位权限是否已授予（iOS：始终允许 / 仅使用期间允许；Android：允许时 / 始终允许）；
- iOS 低电量模式开启时系统会收紧后台权限，临时关闭低电量模式再试。
检查三：存储空间
iPhone / Android 存储空间不足时，应用下载会被系统拦截或速度骤降：
- iOS：设置 → 通用 → iPhone 存储空间，看可用空间。至少留 1GB 以上，推荐 2GB；
- Android：设置 → 存储，看内部存储剩余。
清理方法：删除不常用的应用、照片、视频、微信聊天记录缓存等。
检查四：兔兔助手版本
如果兔兔助手 App 本身版本过旧，可能和当前服务器不兼容。在兔兔助手设置里检查更新，或直接从官方站重新下载最新版覆盖安装。
Safari 从官方站下载兔兔助手本身慢
场景：iOS 用户在 Safari 打开官方站 → 点安装 → 下载描述文件很慢或卡住
可能原因及解决：
- 免费版证书已被吊销：官方站后台的描述文件生成逻辑可能异常。去官方站首页看看有没有 "free is unavailable now" 的提示，有就说明当前没有可用免费证书；
- 官方站 CDN 节点：兔兔助手官方站的 CDN 可能在国内某些运营商线路上延迟较高。试试挂科学上网（如果有的话）下载，或者换个浏览器；
- Safari 下载缓存：Safari 设置 → 下载项 → 清除下载历史；设置 → Safari → 清除历史记录和网站数据。
下载到一半中断
场景：进度条走到 30%、50% 或 80% 时停住，然后提示「下载失败」
排查：
- 网络中断：切换 Wi-Fi / 蜂窝重试；
- 兔兔助手杀进程：下载过程中不要手动杀掉兔兔助手进程，也不要在系统后台管理里"划掉"它；
- 临时存储损坏：兔兔助手在下载过程中会把数据写到临时目录，临时存储满了或权限被收回会导致中途失败——清理手机存储后重试；
- 应用文件源异常：极个别情况下兔兔助手服务器上的某个应用文件本身有问题（上传不完整、服务器临时异常）。过几小时再试，或看看有没有"重试下载"按钮。
Android 端 APK 下载慢
Android APK 通常从兔兔助手 CDN 直接下载。如果浏览器下载 APK 特别慢：
- 换浏览器（Chrome → Firefox，或用手机自带浏览器）；
- 试试用电脑下载 APK 然后通过 USB / 云盘传到手机（避开运营商对大文件的移动网络限速）；
- 确认不是 APK 文件本身有问题——下载完安装时如果提示"文件损坏"就说明下载不完整，换个下载通道。
桌面版下载慢
桌面版的应用下载是直接从兔兔助手服务器拉 IPA，速度取决于电脑网络连接：
- 检查电脑网络是否稳定；
- 关闭占用带宽的其他下载 / 上传任务（网盘同步、Steam 更新等）；
- 桌面版下载过程中如果设备 USB 连接不稳，可能反复重连导致速度下降——确保 USB 线和接口正常。