uni-app调Android广播收不到的根本原因是注册方式错误：必须在原生插件Module中用Application Context长期注册BroadcastReceiver，并通过uni.$invokeMethod或uni.$emit主动将数据推给JS层，而非依赖静态注册或Activity内动态注册。
uni-app 里调不到 Android 广播？先看是不是注册方式错了
绝大多数“收不到广播”的问题，根本不是代码写错，而是 BroadcastReceiver 没在正确时机、以正确方式注册。uni-app 的 JS 层本身不持有 Activity 或 Application 实例，所以不能像纯原生那样在 onCreate() 里动态注册；也不能只靠 AndroidManifest.xml 静态注册就指望 JS 能收到回调——因为广播接收器收到 Intent 后，得有一条通路把数据转给 JS 线程。
真正可行的路径只有一条：在原生插件 Module 里启动一个长期存活的 BroadcastReceiver（通常绑定到 Application Context），并在接收到广播时，通过 uni.$invokeMethod 或 uni.$emit 主动推给 JS 层。
常见错误现象：
-
registerReceiver写在 Activity 里，App 切后台后广播立刻收不到 - 只改了
AndroidManifest.xml，但没在 Java 层做任何转发逻辑，JS 里监听uni.$on('wifiStateChanged')完全无响应 - 用了
Context.registerReceiver(null, ...)这种临时注册，JS 调用完就销毁，无法持续监听
AndroidManifest.xml 该配什么？别乱加 intent-filter
静态注册仅适用于系统级广播（如开机完成、电量变化），且必须满足 Android 8.0+ 对隐式广播的限制。对 WiFi、网络状态这类需持续监听的广播，不建议静态注册，尤其不要在 AndroidManifest.xml 里为你的插件 receiver 堆砌一堆 <intent-filter></intent-filter> —— 大部分会被系统拦截，还可能触发 targetSdkVersion 不兼容警告。
如果真要用静态注册（比如监听 android.intent.action.BOOT_COMPLETED），必须满足：
- receiver 声明带
android:exported="true"（Android 12+ 强制） - manifest 中已声明
android.permission.RECEIVE_BOOT_COMPLETED - receiver 类必须是 public、非内部类，且不能依赖 Activity 生命周期
- JS 层仍需在插件初始化时主动调用一次原生方法，让 receiver 绑定到全局 context 并建立 JS 回调引用
JS 怎么接收广播数据？别等自动触发
uni-app 没有内置的 uni.onBroadcastReceived 这种 API。广播数据从 Android 到 JS，必须由你写的原生模块“推”过去，而不是 JS “拉”。典型做法是：
- 在自定义
UniModule子类中持有一个UniJSCallback引用（例如命名为broadcastCallback），在 JS 首次调用startListening()时保存它 - BroadcastReceiver 收到 Intent 后，解析出 action、extras，组装成 Map 或 JSONObject，调用
callback.invoke(data) - JS 层用
uni.requireNativePlugin('com.example.broadcast.Broadcaster')获取模块，再调用startListening()并传入 success/fail 回调 - 注意：
invokeAndKeepAlive不要滥用——它会阻止 callback 被 GC，若未配对调用removeCallback，可能内存泄漏
示例 JS 调用片段：
const broadcaster = uni.requireNativePlugin('com.example.broadcast.Broadcaster')
broadcaster.startListening({
success: (res) => {
console.log('收到广播:', res.action, res.extra)
},
fail: (err) => {
console.error('监听失败:', err)
}
})
真机上广播收不到？重点查这三处
模拟器往往放行所有广播，一上真机就失效，大概率卡在这几个硬性条件上：
- Android 10+ 设备未开启「允许显示在其他应用上」权限（用于弹窗类广播回调 UI，如网络断开提示）
- 目标广播属于隐式广播（如
WifiManager.SCAN_RESULTS_AVAILABLE_ACTION），而你的 App targetSdkVersion ≥ 30，又没在 manifest 中显式声明android:exported="true"且匹配对应 permission - 原生插件中获取 Context 用了
mUniSDKInstance.getContext()，但它返回的是 Activity Context —— 切后台后容易被回收；应改用mUniSDKInstance.getContext().getApplicationContext() - 没处理 Android 12+ 的
RECEIVER_EXPORTED缺失异常，logcat 里会报java.lang.SecurityException: BroadcastReceiver ComponentInfo not exported
最容易被忽略的一点：广播接收器是否真的在 Application 启动时就注册了？很多插件只在 JS 第一次调用时才注册 receiver，而系统广播（如网络切换）可能早于 JS 初始化就发出了——这时候必须在插件 create 阶段或 Application.onCreate() 里预注册。
