Flutter通讯录权限请求问题：两种需求实现及崩溃排查

崩溃问题分析 #

你的代码在initState()中直接调用异步权限请求，大概率触发了以下问题：

• initState是同步生命周期方法，异步操作可能在上下文未完全初始化时执行，导致showToast这类依赖上下文的操作报错
• IsFirstRun库存在初始化时序风险，不如用SharedPreferences实现首次启动检测更可靠
• 未处理权限被永久拒绝的场景，可能触发异常

权限配置补充（Android） #

除已添加的权限，Android 13+需单独适配通讯录权限拆分逻辑，若你的permission_handler版本≥10.0.0，Permission.contacts会自动兼容，但建议明确声明：

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<!-- Android 13+ 新增写入关联权限（若需操作联系人头像等媒体内容） -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

目标1：持续请求权限直至用户授予 #

修改权限请求逻辑，处理永久拒绝场景，确保在页面渲染完成后执行：

@override
void initState() {
  super.initState();
  // 等待页面渲染完成后执行，避免上下文未就绪问题
  WidgetsBinding.instance.addPostFrameCallback((_) => _requestContactsPermissionLoop());
}

Future<void> _requestContactsPermissionLoop() async {
  PermissionStatus status = await Permission.contacts.status;

  if (status.isGranted) {
    // 权限已授予，执行后续业务逻辑
    return;
  }

  if (status.isPermanentlyDenied) {
    // 引导用户跳转到系统设置页开启权限
    await showDialog(
      context: context,
      builder: (ctx) => AlertDialog(
        title: const Text("权限必需"),
        content: const Text("请在设置中开启通讯录权限，否则App无法正常使用"),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(ctx),
            child: const Text("取消"),
          ),
          TextButton(
            onPressed: () => openAppSettings(),
            child: const Text("去设置"),
          ),
        ],
      ),
    );
    // 用户从设置返回后再次检查权限
    _requestContactsPermissionLoop();
    return;
  }

  // 未永久拒绝，继续请求权限
  PermissionStatus result = await Permission.contacts.request();
  if (!result.isGranted) {
    // 请求失败，递归再次尝试
    _requestContactsPermissionLoop();
  }
}

目标2：首次启动请求，后续未授权则提示退出 #

用SharedPreferences替代IsFirstRun，确保首次启动检测可靠，同时规避上下文问题：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) => _handlePermissionOnLaunch());
}

Future<void> _handlePermissionOnLaunch() async {
  final prefs = await SharedPreferences.getInstance();
  bool isFirstRun = prefs.getBool('is_first_run') ?? true;

  if (await Permission.contacts.isGranted) {
    // 权限已授予，标记首次启动状态为已完成
    if (isFirstRun) await prefs.setBool('is_first_run', false);
    return;
  }

  if (isFirstRun) {
    // 首次启动，发起权限请求
    PermissionStatus result = await Permission.contacts.request();
    await prefs.setBool('is_first_run', false);
    if (!result.isGranted) {
      _showPermissionErrorAndExit();
    }
  } else {
    // 非首次启动且权限未授予，提示后退出App
    _showPermissionErrorAndExit();
  }
}

void _showPermissionErrorAndExit() {
  showDialog(
    context: context,
    barrierDismissible: false,
    builder: (ctx) => AlertDialog(
      title: const Text("权限错误"),
      content: const Text("通讯录权限未开启，App无法运行"),
      actions: [
        TextButton(
          onPressed: () {
            Navigator.pop(ctx);
            // Android退出App
            SystemNavigator.pop();
            // iOS建议引导用户手动关闭，避免审核问题：
            // exit(0);
          },
          child: const Text("确定"),
        ),
      ],
    ),
  );
}

关键注意事项 #

• 禁止在initState直接调用异步方法，必须用WidgetsBinding.instance.addPostFrameCallback确保上下文就绪
• 必须处理权限永久拒绝的场景，避免无限循环请求引发ANR
• Android 13+权限适配需注意拆分逻辑，建议使用permission_handler 10.0.0及以上版本
• iOS退出App尽量引导用户手动操作，直接调用exit(0)可能触发审核警告

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