Flutter中Android与iOS通知权限弹窗无法弹出问题求助

一、先检查平台配置（核心原因） #

Android 端配置 #

• 针对Android 13（API 33及以上），必须在android/app/src/main/AndroidManifest.xml中添加权限声明：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

• API 33以下的Android系统，通知权限默认开启，无需额外声明，所以不会触发权限弹窗，这是系统默认行为。

iOS 端配置 #

• 必须在ios/Runner/Info.plist中添加权限用途描述，否则系统会直接静默拒绝请求，不会弹出弹窗：

<key>NSUserNotificationUsageDescription</key>
<string>需要通知权限向您推送订单更新、活动提醒等重要消息</string>
<key>NSAlertUsageDescription</key> <!-- iOS 15+ 建议补充，增强权限说明 -->
<string>允许通知权限后，我们会通过弹窗提醒您相关消息</string>

• 注意：描述文本不能为空，必须明确说明权限用途，否则可能影响App Store审核。

二、修正permission_handler的代码逻辑 #

1. 选对请求时机 #

不要在main函数等App未完全初始化的阶段请求权限，建议在首页的initState中调用：

import 'package:permission_handler/permission_handler.dart';

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  @override
  void initState() {
    super.initState();
    _askNotificationPermission();
  }

  Future<void> _askNotificationPermission() async {
    final status = await Permission.notification.request();
    
    // 根据权限状态做对应处理
    switch (status) {
      case PermissionStatus.granted:
        // 权限已允许，可正常发送通知
        break;
      case PermissionStatus.denied:
        // 用户临时拒绝，可后续再次引导请求
        break;
      case PermissionStatus.permanentlyDenied:
        // 用户永久拒绝，只能引导到系统设置页开启
        if (await Permission.notification.isPermanentlyDenied) {
          openAppSettings();
        }
        break;
      default:
        break;
    }
  }

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      body: Center(child: Text('首页')),
    );
  }
}

2. 确保使用最新版permission_handler #

旧版本可能存在新系统适配问题，在pubspec.yaml中更新到稳定版：

dependencies:
  permission_handler: ^11.0.1 # 替换为当前最新稳定版本

三、其他排查点 #

• 系统权限历史：如果用户之前手动拒绝过权限，系统不会再次弹出请求弹窗，此时需要引导用户进入App设置页开启（代码中的openAppSettings()可直接跳转）。
• 测试环境：iOS模拟器偶尔会出现权限弹窗不显示的情况，建议用真机测试；Android API33以下设备默认开启通知权限，不会弹窗，属于正常现象。

内容的提问来源于stack exchange，提问作者Prashanth Kumar D S