CatShare常见问题解答收文件超时、发送失败、权限报错的10个排查方案清单【免费下载链接】CatShare类原生 海外设备现已加入互传联盟。项目地址: https://gitcode.com/gh_mirrors/ca/CatShareCatShare 是一款免费开源的 Android 互传应用支持蓝牙设备发现、文件接收、文件发送需 Shizuku 辅助与文本共享可让海外设备与国产机型互传文件。如果你遇到收文件超时、发送失败、权限报错等问题可以对照本文的 10 个排查方案清单快速定位原因。先了解 CatShare 的互传原理排查前先读CatShare 采用「蓝牙发现 WiFi DirectP2P传输」方案 接收方启动接收服务通过蓝牙持续广播自己的设备信息 发送方扫描并发现接收方通过蓝牙信道协商出 WiFi Direct 连接参数 双方建立 WiFi Direct 点对点连接高速传输文件。明白这条链路后排查时就能迅速判断「断在哪一环」。核心源码位置接收方蓝牙广播服务app/src/main/java/moe/reimu/catshare/services/GattServerService.kt发送方点对点连接app/src/main/java/moe/reimu/catshare/services/P2pSenderService.ktWiFi P2P 建组与连接app/src/main/java/moe/reimu/catshare/utils/P2pUtils.kt常见报错速查表报错提示最可能原因一键解决方向等待发送请求超时接收方未启动接收服务方案 1蓝牙已关闭或不可用蓝牙没开方案 2WiFi 已关闭或不可用WiFi 开关未打开方案 3点对点连接建立失败P2P 组网异常方案 4WebSocket / 握手超时信号干扰、链路不稳方案 5Shizuku 不可用 / 未授权发送前置条件缺失方案 6权限被拒绝系统权限未授予方案 7正在进行其他任务上一条传输未完成方案 8分享内容为空或无法读取分享内容异常方案 9发送 / 接收中断被取消或链路断开方案 10CatShare 收文件超时的 10 个排查方案1. 收文件超时确认接收方已开启「接收服务」发送方提示「等待发送请求超时」时十有八九是接收方的接收服务没有运行或被系统杀掉了。请在接收方重新打开应用并启动接收服务启动成功后通知栏会出现「CatShare 接收服务」常驻通知——请保留该通知不要手动清除它是蓝牙广播持续运行的保障入口见app/src/main/java/moe/reimu/catshare/services/GattServerService.kt。2. 「蓝牙已关闭或不可用」先开蓝牙接收服务启动时会检查蓝牙状态蓝牙未开启会直接退出提示文案定义于app/src/main/res/values-zh-rCN/strings.xml。打开蓝牙后重启接收服务即可个别机型还需确认蓝牙开关没有被省电策略重置。3. 「WiFi 已关闭或不可用」打开 WiFi 开关虽然互传走的是 WiFi Direct不需要连接任何网络但系统要求 WiFi 开关必须处于打开状态。请确认发送与接收两侧的 WiFi 开关都已开启再重试。4. 「点对点连接建立失败」重启 WiFi 并靠近设备该报错对应 P2P 组网或连接失败见app/src/main/java/moe/reimu/catshare/utils/P2pUtils.kt中createGroupSuspend/connectSuspend抛出的异常。建议把两侧手机的 WiFi关闭再重新打开释放之前残留的 P2P 组让两台设备靠近到 1 米以内关闭附近正在使用的热点、其他互传工具避免 P2P 通道被占用错误码BUSY即表示设备忙。5. 「WebSocket 连接超时 / 发送握手超时」减少干扰、缩短距离这类超时说明蓝牙握手已成功但数据链路不稳定。请尽量靠近设备、避开人多的商场/地铁 WiFi 环境后重试若反复出现可升级到最新版本再测。6. Shizuku 不可用 / 未授权发送文件的必备检查文件发送功能依赖 Shizuku 获取设备 MAC 地址互传联盟协议要求以 MAC 作为认证信息Android 已禁止普通应用直接读取。若应用内显示「Shizuku 不可用」或「Shizuku 未授权」安装 Shizuku 并按其引导启动回到 CatShare 授予 Shizuku 授权看到「Shizuku 可用」后再执行发送。相关实现见app/src/main/java/moe/reimu/catshare/utils/ShizukuUtils.kt。7. 权限报错一次性授予蓝牙、位置与附近 WiFi 权限CatShare 需要的运行时权限随系统版本不同见app/src/main/java/moe/reimu/catshare/utils/PermissionUtils.ktAndroid 12API 31及以上需授予蓝牙广播、蓝牙扫描、蓝牙连接 3 项权限Android 13 及以上还需「附近的 WiFi 设备」权限用于 WiFi DirectAndroid 13 及以下需要「精确位置」权限扫描蓝牙/WiFi 设备的系统硬性要求仅用于发现设备。请到系统「设置 → 应用 → 权限」中逐项确认漏掉任何一项都会导致发现失败。8. 「正在进行其他发送/接收任务」等待或停止当前任务CatShare 同一时间只处理一个传输任务。若上一条任务卡住可从通知栏点击「停止」或在接收侧关闭接收服务后重新发起。9. 「分享内容为空或无法读取」检查分享内容当通过系统「分享」菜单唤起 CatShare 时若源应用传过来的内容为空如空文本、无效 URI会给出该提示。请重新选择具体的文件/照片再分享照片类内容建议直接从图库分享。10. 「发送中断 / 接收中断」或「传输已被对端设备取消」中断提示对应通知文案「文件发送已中断 / 文件接收已中断」常见于传输中距离拉远、信号变差任一方在通知栏手动点了「停止」此时会显示「传输已被本设备/对端设备取消」部分接收方品牌如 OPPO/一加完成接收后发送端可能误报「接收失败」文件通常已送达可在接收方确认后再重发。 小提示在设置页app/src/main/java/moe/reimu/catshare/SettingsActivity.kt可以开启「显示详细错误信息」失败时会展示更具体的错误原因还可以修改「设备名称」方便在多台设备时识别接收方。仍然解决不了捕获日志并汇报问题如果按以上 10 个方案排查后问题依旧请借助日志定位打开 CatShare设置 → 捕获日志应用会把当前 logcat 日志导出为可分享的文本文件在项目 issue 区提交问题描述附上日志、并说明「从什么时候开始发送/接收」开发团队会据此定位。也可以手动用 adb 抓取日志详见项目 READMEadb logcat --pid $(adb shell pidof -s moe.reimu.catshare)⚠️ 提示GitHub Release 与 F-Droid 渠道的 CatShare 签名一致可任选安装遇到版本差异问题时建议统一使用最新版。祝互传顺畅有问题欢迎随时反馈 【免费下载链接】CatShare类原生 海外设备现已加入互传联盟。项目地址: https://gitcode.com/gh_mirrors/ca/CatShare创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考