Flutter如何解决auth.getavailablebiometrics()获取不到指纹的问题

在Flutter项目中，使用auth.getAvailableBiometrics()方法无法获取到设备的指纹信息。我已经确认设备支持指纹识别，并且在系统设置中已经启用了指纹功能。尝试过以下方法：

  1. 检查了AndroidManifest.xml和Info.plist的权限配置
  2. 确保模拟器和真机都开启了指纹解锁功能
  3. 测试了不同版本的local_auth插件
    但始终返回空列表或报错。请问可能是什么原因导致的？是否需要额外配置或处理特定平台代码？
2 回复

检查设备是否支持指纹，并确保在AndroidManifest.xml中添加USE_FINGERPRINT权限。在iOS中，确认Info.plist包含NSFaceIDUsageDescription。重启设备或重置生物识别设置。

更多关于Flutter如何解决auth.getavailablebiometrics()获取不到指纹的问题的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中，auth.getAvailableBiometrics() 方法无法获取到指纹设备时，可以按照以下步骤排查和解决：

1. 检查设备硬件和系统支持

  • 确认设备具备指纹传感器：部分设备可能没有指纹硬件。
  • 检查系统版本：Android需6.0（API 23）或以上，iOS需iOS 9或以上。
  • 验证是否已录入指纹：设备必须至少录入一个指纹才能被识别。

2. 配置权限（Android）

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

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

3. 检查插件版本和兼容性

确保使用最新版本的 local_auth 插件（如 ^2.1.0 或更高），在 pubspec.yaml 中更新：

dependencies:
  local_auth: ^2.1.0

4. 添加平台特定配置

Android：

  • 在 android/app/build.gradle 中设置 minSdkVersion 至少为 23：
    android {
    defaultConfig {
        minSdkVersion 23
    }
}

iOS：

  • 在 ios/Runner/Info.plist 中添加以下键值对，说明使用生物识别的原因：
    <key>NSFaceIDUsageDescription</key>
<string>我们需要使用指纹/面容ID来验证您的身份</string>

5. 代码实现和错误处理

使用 try-catch 捕获异常，并检查返回的生物识别类型列表：

import 'package:local_auth/local_auth.dart';

final LocalAuthentication auth = LocalAuthentication();

void checkBiometrics() async {
  try {
    List<BiometricType> availableBiometrics = await auth.getAvailableBiometrics();
    
    if (availableBiometrics.contains(BiometricType.strong) ||
        availableBiometrics.contains(BiometricType.weak) ||
        availableBiometrics.contains(BiometricType.fingerprint)) {
      print("指纹可用");
    } else {
      print("未找到指纹功能");
    }
  } catch (e) {
    print("获取生物识别信息失败: $e");
  }
}

6. 测试不同场景

  • 在真机上测试（模拟器可能不支持指纹）。
  • 重启设备，排除临时系统问题。

总结

通过以上步骤，通常可以解决指纹无法获取的问题。如果问题持续存在，检查设备日志或使用 local_auth 插件的 canCheckBiometrics 方法确认生物识别功能是否可用。

回到顶部