Android中BroadcastReceiver内显示AlertDialog报BadTokenException求助

这个报错的核心原因很明确：BroadcastReceiver是无UI上下文的短生命周期组件，它没有关联的窗口容器，直接调用AlertDialog的show()方法时，系统无法找到合适的WindowManager令牌来挂载这个对话框，所以抛出BadTokenException。

下面给你几种靠谱的解决方案，按推荐程度排序：

方案1：用透明Activity承载对话框（最稳妥的UI提醒方式） #

创建一个主题完全透明的Activity，把对话框的逻辑放在这个Activity里，然后在BroadcastReceiver中启动这个Activity。这样既符合Android的组件生命周期规范，又能正常展示对话框。

步骤1：创建透明主题的Activity #

public class DialogActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 设置透明背景，避免Activity本身显示
        getWindow().setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
        
        // 构建并显示对话框
        AlertDialog.Builder builder = new AlertDialog.Builder(this);
        builder.setTitle("状态提醒")
               .setMessage("需要检查你的位置状态")
               .setPositiveButton("确定", (dialog, which) -> finish()) // 点击确定关闭Activity
               .setCancelable(false);
        
        AlertDialog dialog = builder.create();
        dialog.show();
    }

    @Override
    public void onBackPressed() {
        // 点击返回键直接关闭Activity
        finish();
        super.onBackPressed();
    }
}

步骤2：在Manifest中配置Activity的透明主题 #

在<application>标签下添加这个Activity的声明，并指定透明主题：

<activity
    android:name=".DialogActivity"
    android:theme="@style/TransparentActivityTheme"
    android:launchMode="singleInstance"
    android:excludeFromRecents="true"/>

然后在styles.xml中定义透明主题：

<style name="TransparentActivityTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@android:style/Animation.Translucent</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowFullscreen">false</item>
</style>

步骤3：在BroadcastReceiver中启动这个Activity #

修改你的onReceive方法，启动DialogActivity：

public class MyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if ("android.intent.action.BOOT_COMPLETED".equals(intent.getAction())) {
            // 启动透明Activity，必须添加FLAG_ACTIVITY_NEW_TASK
            Intent dialogIntent = new Intent(context, DialogActivity.class);
            dialogIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(dialogIntent);
        }
    }
}

方案2：使用Notification提醒（推荐的系统级交互方式） #

从Android的设计规范来说，BroadcastReceiver属于后台组件，直接弹出对话框会打断用户当前的操作体验，系统在高版本中也会限制这种行为。更合适的方式是发送一条Notification，用户点击后再打开对应的UI。

示例代码：

public void statusCheck(Context context) {
    // 创建NotificationChannel（Android 8.0+必须）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel("alarm_channel", "状态提醒", NotificationManager.IMPORTANCE_DEFAULT);
        NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
        notificationManager.createNotificationChannel(channel);
    }

    // 点击通知后打开DialogActivity
    Intent intent = new Intent(context, DialogActivity.class);
    PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);

    // 构建Notification
    NotificationCompat.Builder builder = new NotificationCompat.Builder(context, "alarm_channel")
            .setSmallIcon(R.drawable.ic_notification) // 必须设置小图标
            .setContentTitle("位置状态检查")
            .setContentText("请确认你的位置服务状态")
            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
            .setContentIntent(pendingIntent)
            .setAutoCancel(true);

    // 发送Notification
    NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
    notificationManager.notify(1, builder.build());
}

方案3：临时解决方案（不推荐，兼容性差） #

如果你非要在BroadcastReceiver中直接弹出对话框，可以尝试给Dialog的Window设置特殊的Flags，但这种方法在Android 8.0+系统中可能被限制，而且用户体验不好：

public void statusCheck(Context context) {
    AlertDialog.Builder builder = new AlertDialog.Builder(context);
    builder.setTitle("提示")
           .setMessage("位置服务状态需要检查");
    
    AlertDialog dialog = builder.create();
    
    // 设置Window类型和Flags
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        dialog.getWindow().setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY);
    } else {
        dialog.getWindow().setType(WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
    }
    dialog.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRY_AGAIN | WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM);
    
    dialog.show();
}

注意：这种方式需要申请SYSTEM_ALERT_WINDOW权限，而且在Android 10+中，即使申请了权限，也可能被系统拦截，所以不推荐使用。

内容的提问来源于stack exchange，提问作者M.ArslanKhan