尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
CatShare常见问题解答:收文件超时、发送失败、权限报错的10个排查方案清单
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),仅供参考
RELATED

相关推荐

PDF解除限制:5步把PDF的复制打印限制踢掉

PDF解除限制:5步把PDF的复制打印限制踢掉

PDF解除限制:5步把PDF的复制打印限制踢掉 【免费下载链接】PDFPatcher PDF补丁丁——PDF工具箱,可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档,探查文档结构,提取图片、转成图片等等 项目地址: https://gitcode.com/Gi…

📅 2026/11/14 22:21:27
PortSwigger网络缓存欺骗(1)

PortSwigger网络缓存欺骗(1)

实验:利用路径映射欺骗网页缓存 要完成这个实验,你需要知道: 正则表达式端点如何将 URL 路径映射到资源。如何检测和利用缓存服务器和源服务器映射 URL 路径方式的差异。 使用以下凭据登录您自己的帐户wiener:peter 登录后便可以repeter账…

📅 2026/11/17 1:12:20
Open-Xml-PowerTools 修订标记处理:RevisionAccepter 批量接受/拒绝Word修订的完整流程

Open-Xml-PowerTools 修订标记处理:RevisionAccepter 批量接受/拒绝Word修订的完整流程

Open-Xml-PowerTools 修订标记处理:RevisionAccepter 批量接受/拒绝Word修订的完整流程 【免费下载链接】Open-Xml-PowerTools 项目地址: https://gitcode.com/gh_mirrors/ope/Open-Xml-PowerTools 在处理协作办公文档时,Word 修订标记&#xff…

📅 2026/11/15 22:55:36
MORE NEWS

更多资讯

📰

滁州培训电工证怎么考 学历不高怕报不上名含金量还在吗

滁州培训电工证怎么考 学历不高怕报不上名含金量还在吗 你是不是也担心自己学历不高,考电工证是不是会被拒之门外?别急,今天就带你搞清楚滁州培训电工证怎么考,含金量到底还在不在,还有那些你可能不知道的避坑技巧。 学历不高也能考,但得选对方法…

📰

工地太忙根本没时间复习考试,高级技工电工证怎么考多少钱

工地太忙根本没时间复习考试,高级技工电工证怎么考多少钱 你不是一个人在战斗,工地上的电工兄弟们大多都面临同样的问题:项目紧、任务重,根本没时间复习备考,但又不能耽误考取高级技工电工证。今天咱们就来聊聊, 高级技工电工证怎么考多少钱…

📰

罗村边度有考电工证多少钱?怕考不过白交培训费的看这篇

罗村边度有考电工证多少钱?怕考不过白交培训费的看这篇 怕考不过白交培训费?你不是一个人。很多人在罗村边度有考电工证的时候,最怕的就是花了钱,最后没拿到证,白白浪费时间和金钱。其实,只要你掌握好流程,选择正规的培训机构,就完全能避免这种坑。下…

📰

开封市电工证考试实操怕挂科?全流程避坑指南来了

开封市电工证考试实操怕挂科?全流程避坑指南来了 实操考试心里没底怕挂科?别慌,你不是一个人在战斗。很多电工从业者,尤其是像南阳卧龙区从事市政公用工程的同行们,常常在报名【开封市电工证考试】时担心操作不熟练、流程不熟悉、考试时间不够,甚至担心…

📰

顺义人学电工证多少钱选对培训机构不踩坑

顺义人学电工证多少钱选对培训机构不踩坑 怕考不过白交培训费?顺义人学电工证多少钱?选错机构不仅钱打水漂,还耽误你找工作甚至入职资格。电工证是特种作业人员必须持有的“通行证”,但市面上培训机构良莠不齐,很多人因为没选对机构,要么考不过,要么花…

📰

弱电电工证学习资料通过率揭秘:怎么避免被中介坑?

弱电电工证学习资料通过率揭秘:怎么避免被中介坑? 不知道去哪报名怕被中介坑,是不是你现在的烦恼?弱电电工证学习资料虽然在网上一搜一大堆,但真正能帮你拿到证、考过的,少之又少。特别是在济源房建工程这一块,很多从业者对这个证书的认知还停留在“只…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬