Capacitor iOS端生物识别异常周期性调用问题排查求助

问题背景 #

我们的应用基于CapacitorJS 6.0.0 + Angular 18.2.2开发，使用capacitor-native-biometric 4.2.2库。新版本发布后Android端运行正常，但TestFlight的iOS版本每约25秒会触发非预期的FaceID校验：应用先无响应几秒，随后弹出FaceID请求。

排查后确认核心问题：应用会被意外杀死，Angular app.component构造函数重新执行，因本地数据被清除，导致再次触发FaceID校验流程。

已尝试的排查动作：

• 更换不同iPhone设备、模拟器测试
• 调整capacitor-native-biometric库版本，甚至替换该库
• 重装应用
• 确认info.plist中NSFaceIDUsageDescription配置未变更

当前怀疑首次FaceID校验前的NativeBiometric.isAvailable()调用可能是问题来源，需要明确应用被杀的原因，以及是否遗漏了iOS/Capacitor最新更新的影响因素。

可能的原因及排查方向 #

1. Capacitor 6的iOS生命周期/内存管理变更 #

Capacitor 6对iOS端的生命周期处理、WebView内存管理做了不少更新，可能引发问题的点包括：

• AppRestored等新事件的处理逻辑异常，导致应用从后台恢复时触发重启
• WebView内存阈值调整，TestFlight环境下（系统内存限制更严格），应用因内存占用过高被强杀
• SplashScreen插件行为变更，意外触发应用重启

排查建议：

• 在app.component中监听Capacitor的App事件（appRestored、appTerminated、appCrash），打印日志确认应用被杀的时机和触发事件
• 用Xcode的Memory Graph Debugger分析TestFlight版本的内存占用，排查是否存在内存泄漏导致系统强杀

2. Angular 18的Hydration功能冲突 #

Angular 18默认启用Hydration（客户端水合），如果和Capacitor原生容器结合不当，可能导致：

• 客户端水合失败，触发应用强制重启
• 未正确处理ApplicationRef.isStable状态，导致循环渲染或内存溢出

排查建议：

• 临时禁用Angular Hydration（在main.ts中移除provideClientHydration()），测试是否还会出现重启问题
• 在app.component中订阅ApplicationRef.isStable状态并打印日志，确认应用是否稳定，是否有频繁状态变更导致崩溃

3. NativeBiometric.isAvailable()的异步阻塞问题 #

虽然替换了库仍有问题，但TestFlight环境下的权限校验逻辑和本地调试可能存在差异：

• isAvailable()调用在iOS后台线程阻塞，导致主线程无响应，被系统判定为未响应而杀死
• iOS 17+的生物识别权限逻辑变更，isAvailable()触发的权限请求未正确处理，导致应用进入异常状态

排查建议：

• 将NativeBiometric.isAvailable()的调用从构造函数移到ngOnInit中，并用async/await包裹，避免阻塞组件初始化
• 给isAvailable()添加超时处理，防止无限阻塞：

async checkBiometricAvailability() {
  try {
    const result = await Promise.race([
      NativeBiometric.isAvailable(),
      new Promise((_, reject) => setTimeout(() => reject(new Error('校验超时')), 5000))
    ]);
    // 处理生物识别可用结果
  } catch (err) {
    // 超时或错误处理逻辑
  }
}

4. iOS TestFlight的环境限制 #

TestFlight版本会触发iOS的严格检测规则，可能的限制包括：

• 后台执行时间限制：如果应用有30秒周期的后台任务，可能因超过iOS后台执行时长被系统杀死
• 隐私权限校验：FaceID权限请求的频率或时机不符合iOS规范，导致应用被限制

排查建议：

• 检查30秒周期功能的实现，确认是否使用了Capacitor的BackgroundTask插件，且正确调用finish()方法释放后台任务
• 确认info.plist中是否添加了必要的后台模式权限（如果应用需要后台运行），避免因权限不足被系统杀死

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