如何向Manifest中的接收器发送自定义广播？MyReceiver.onReceive未触发排查

安全阿岳

2026-5-20

嘿，我来帮你搞定这两个Android广播相关的问题！

1. 如何向AndroidManifest.xml中的接收器发送自定义广播动作？

其实步骤很清晰，我给你拆解成几步：

第一步：定义唯一的广播动作
先在代码里定义一个带包名前缀的动作常量，避免和其他应用冲突，比如在MainActivity里：
```
public static final String CUSTOM_BROADCAST_ACTION = "com.yourpackage.yourapp.ACTION_MY_CUSTOM";
```

第二步：在Manifest中完成接收器注册
确保你的MyReceiver已经绑定了对应的动作过滤，示例代码如下：

<application ...>
    <receiver 
        android:name=".MyReceiver"
        android:exported="false"> <!-- 仅接收自身应用广播的话，设为false更安全 -->
        <intent-filter>
            <action android:name="com.yourpackage.yourapp.ACTION_MY_CUSTOM" />
        </intent-filter>
    </receiver>
</application>

第三步：发送自定义广播
重点注意：Android 8.0（API 26）及以上版本，静态注册的接收器无法接收隐式广播，必须用显式Intent发送：

// 方式一：直接指定接收器类
Intent broadcastIntent = new Intent(this, MyReceiver.class);
broadcastIntent.setAction(CUSTOM_BROADCAST_ACTION);
sendBroadcast(broadcastIntent);

// 方式二：通过组件名指定接收器
Intent broadcastIntent = new Intent(CUSTOM_BROADCAST_ACTION);
broadcastIntent.setComponent(new ComponentName(this, MyReceiver.class));
sendBroadcast(broadcastIntent);

要是你的应用只针对API 25及以下，隐式Intent也能生效，但还是推荐用显式的，更可靠安全。

2. MyReceiver的onReceive始终未触发？排查这些常见坑！

既然已经完成注册却没触发，大概率是某个细节没踩对，我给你列几个最容易遗漏的点：

动作名完全不匹配
检查Manifest里intent-filter的action名称，和你发送广播时设置的动作名是不是完全一致——大小写、包名前缀、字符都不能错，多一个空格都会导致匹配失败。
Android 8.0+用了隐式广播发送
这是高频坑！API 26及以上，静态注册的接收器不支持隐式Intent。如果你还在直接用new Intent(CUSTOM_ACTION)发送，没有指定接收器类/组件，系统会直接忽略这个广播，赶紧改成显式Intent试试。
接收器类名路径写错
核对Manifest里android:name=".MyReceiver"的路径，要是你的接收器在子包（比如com.yourapp.receivers.MyReceiver），就得写成android:name=".receivers.MyReceiver"或者全类名，路径错了系统找不到接收器。
权限或exported属性设置问题
如果你的接收器android:exported="true"（允许跨应用接收），但没配置对应的权限，可能会被系统拦截；如果不需要跨应用接收，直接把exported设为false，既能避免权限问题，也更安全。
广播被系统后台优化拦截
部分国产厂商的系统（小米、华为等）有严格的后台限制，要是你的应用在后台运行，广播可能被拦截。可以先在前台测试，或者把应用加入系统后台白名单试试。
发送广播的代码根本没执行
加个Log或者断点，确认sendBroadcast那行代码是不是真的被触发了——比如按钮点击事件没绑定、条件判断不满足，都会导致广播没发出去。
接收器onReceive里有未捕获异常
如果onReceive里抛出了未处理的异常，接收器会被系统直接杀死，看起来像是没触发。可以在方法开头加个Log验证：
```
@Override
public void onReceive(Context context, Intent intent) {
    Log.d("MyReceiver", "广播已接收！动作：" + intent.getAction());
    // 其他业务逻辑
}
```
查看Logcat有没有这条输出，就能排除是代码异常导致的问题。

内容的提问来源于stack exchange，提问作者Yairopro