Flutter Android：alarm_manager_plus应用终止时无法唤起应用的解决咨询

针对你遇到的应用终止或锁屏状态下闹钟无法唤起的问题，核心原因是Android系统的后台限制、权限缺失以及闹钟配置不完整，以下是具体解决步骤：

1. 补充必要权限 #

在android/app/src/main/AndroidManifest.xml中添加以下权限：

<!-- Android 12+ 精确闹钟权限 -->
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />
<uses-permission android:name="android.permission.USE_EXACT_ALARM" />
<!-- 唤醒设备权限 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- 后台启动权限（部分厂商需要） -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

在Flutter代码中动态申请SCHEDULE_EXACT_ALARM权限（需依赖permission_handler插件）：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestAlarmPermission() async {
  final status = await Permission.scheduleExactAlarm.request();
  if (!status.isGranted) {
    // 引导用户前往设置页开启权限
    await openAppSettings();
  }
}

2. 配置闹钟时启用关键参数 #

调用oneShot时必须指定allowWhileIdle和wakeup参数，确保锁屏/idle状态下能触发：

await AndroidAlarmManager.oneShot(
  const Duration(seconds: 10),
  1001, // 唯一闹钟ID，避免冲突
  _alarmCallback,
  allowWhileIdle: true, // 允许在设备idle状态触发
  wakeup: true, // 唤醒设备屏幕/CPU
  exact: true, // 确保精确触发
);

3. 正确实现闹钟回调逻辑 #

回调函数必须在独立隔离区运行，不能依赖Flutter UI上下文，且需配合唤醒锁和本地通知唤起应用：

import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:flutter_wake_lock/flutter_wake_lock.dart';
import 'package:android_alarm_manager_plus/android_alarm_manager_plus.dart';

// 全局通知插件实例
final FlutterLocalNotificationsPlugin _notificationsPlugin = FlutterLocalNotificationsPlugin();

// 初始化通知配置
Future<void> _initNotifications() async {
  const AndroidInitializationSettings androidSettings = AndroidInitializationSettings('@mipmap/ic_launcher');
  const InitializationSettings settings = InitializationSettings(android: androidSettings);
  await _notificationsPlugin.initialize(settings);
}

// 闹钟回调函数（必须是顶级/静态函数）
static Future<void> _alarmCallback() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 保持设备唤醒
  await FlutterWakeLock.enable();
  
  // 初始化通知插件
  final FlutterLocalNotificationsPlugin notifications = FlutterLocalNotificationsPlugin();
  const AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
    'alarm_channel',
    '闹钟通知',
    importance: Importance.max,
    priority: Priority.high,
    fullScreenIntent: true, // 全屏通知，强制唤起屏幕
  );
  const NotificationDetails details = NotificationDetails(android: androidDetails);
  
  // 发送通知，用户点击后打开应用
  await notifications.show(
    1001,
    '闹钟提醒',
    '你的闹钟时间到了',
    details,
    payload: 'alarm_payload', // 可传递参数给应用
  );
  
  // 延迟释放唤醒锁，确保通知正常显示
  await Future.delayed(const Duration(seconds: 5));
  await FlutterWakeLock.disable();
  
  // 终止隔离区
  exit(0);
}

4. 处理厂商后台管控限制 #

国内小米、华为、OPPO等厂商的系统会严格限制后台应用，需引导用户手动开启以下权限：

• 自启动权限（允许应用被系统唤醒）
• 后台活动权限（允许应用在后台持续运行）
• 忽略电池优化（避免系统因省电杀死应用）

可以通过代码跳转至应用设置页：

import 'package:url_launcher/url_launcher.dart';
import 'package:package_info_plus/package_info_plus.dart';

Future<void> openAppSettings() async {
  final PackageInfo packageInfo = await PackageInfo.fromPlatform();
  final Uri settingsUri = Uri.parse('package:${packageInfo.packageName}/settings');
  if (await canLaunchUrl(settingsUri)) {
    await launchUrl(settingsUri);
  }
}

5. 验证闹钟注册状态 #

每次启动应用时，重新注册未触发的闹钟（避免应用重启后闹钟丢失）：

void _reRegisterAlarms() async {
  // 这里可以从本地存储读取未触发的闹钟信息，重新注册
  await AndroidAlarmManager.oneShot(...);
}

@override
void initState() {
  super.initState();
  _initNotifications();
  requestAlarmPermission();
  _reRegisterAlarms();
}

内容的提问来源于stack exchange，提问作者홍정민