iOS本地认证（TouchID）失败提示框正文内容修改求助

嘿，这个问题我太熟了——iOS的LocalAuthentication框架默认就是这样的：第一次调用认证时设置的reason文本会被系统缓存，重试时只会改标题为「Repeat」，正文不会自动更新。你直接改reason字符串没用，因为旧的LAContext实例已经绑定了最初的reason，没法动态修改。

要实现失败时修改弹窗正文，必须在认证失败后重新创建一个新的LAContext实例，更新reason文本后再次发起认证请求。每次新的LAContext会带着新的reason生成新的弹窗，这样就能替换正文内容了。

Xamarin C# 代码示例 #

private void StartTouchIDAuth(string reasonText)
{
    var context = new LAContext(); // 每次都新建实例
    NSError authError;

    if (context.CanEvaluatePolicy(LAPolicy.DeviceOwnerAuthenticationWithBiometrics, out authError))
    {
        var replyHandler = new LAContextReplyHandler((success, error) =>
        {
            InvokeOnMainThread(() =>
            {
                if (success)
                {
                    // 认证成功：处理后续逻辑，比如跳转页面
                    Console.WriteLine("TouchID认证成功");
                }
                else
                {
                    if (error != null)
                    {
                        switch ((LAError)error.Code)
                        {
                            case LAError.AuthenticationFailed:
                                // 指纹不匹配，更新reason并重试
                                var newReason = "哎呀，指纹不对~ 请再试一次！";
                                StartTouchIDAuth(newReason);
                                break;
                            case LAError.UserCancel:
                                // 用户主动取消，不重试
                                Console.WriteLine("用户取消认证");
                                break;
                            case LAError.UserFallback:
                                // 用户选择了 fallback 选项，可根据需求决定是否重试
                                var fallbackReason = "试试用指纹重新认证？";
                                StartTouchIDAuth(fallbackReason);
                                break;
                            default:
                                // 其他不可重试错误（比如设备不支持、没有录入指纹）
                                Console.WriteLine($"认证错误：{error.LocalizedDescription}");
                                break;
                        }
                    }
                }
            });
        });

        context.EvaluatePolicy(LAPolicy.DeviceOwnerAuthenticationWithBiometrics, new NSString(reasonText), replyHandler);
    }
    else
    {
        // 设备不支持TouchID或未录入指纹
        Console.WriteLine($"设备不支持：{authError?.LocalizedDescription}");
    }
}

// 首次调用
StartTouchIDAuth("请用指纹验证身份");

Objective-C 代码示例 #

- (void)startTouchIDAuthWithReason:(NSString *)reason {
    LAContext *context = [[LAContext alloc] init]; // 新建实例
    NSError *authError;

    if ([context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&authError]) {
        [context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics
                localizedReason:reason
                          reply:^(BOOL success, NSError * _Nullable error) {
            dispatch_async(dispatch_get_main_queue(), ^{
                if (success) {
                    NSLog(@"TouchID认证成功");
                    // 处理成功逻辑
                } else {
                    if (error) {
                        switch (error.code) {
                            case LAErrorAuthenticationFailed: {
                                NSString *newReason = @"哎呀，指纹不对~ 请再试一次！";
                                [self startTouchIDAuthWithReason:newReason];
                                break;
                            }
                            case LAErrorUserCancel:
                                NSLog(@"用户取消认证");
                                break;
                            case LAErrorUserFallback: {
                                NSString *fallbackReason = @"试试用指纹重新认证？";
                                [self startTouchIDAuthWithReason:fallbackReason];
                                break;
                            }
                            default:
                                NSLog(@"认证错误：%@", error.localizedDescription);
                                break;
                        }
                    }
                }
            });
        }];
    } else {
        NSLog(@"设备不支持：%@", authError.localizedDescription);
    }
}

// 首次调用
[self startTouchIDAuthWithReason:@"请用指纹验证身份"];

Swift 代码示例 #

func startTouchIDAuth(with reason: String) {
    let context = LAContext() // 新建实例
    var authError: NSError?

    if context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
        context.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, localizedReason: reason) { [weak self] success, error in
            DispatchQueue.main.async {
                guard let self = self else { return }
                if success {
                    print("TouchID认证成功")
                    // 处理成功逻辑
                } else {
                    guard let error = error as? LAError else { return }
                    switch error.code {
                    case .authenticationFailed:
                        let newReason = "哎呀，指纹不对~ 请再试一次！"
                        self.startTouchIDAuth(with: newReason)
                    case .userCancel:
                        print("用户取消认证")
                    case .userFallback:
                        let fallbackReason = "试试用指纹重新认证？"
                        self.startTouchIDAuth(with: fallbackReason)
                    default:
                        print("认证错误：\(error.localizedDescription)")
                    }
                }
            }
        }
    } else {
        print("设备不支持：\(authError?.localizedDescription ?? "")")
    }
}

// 首次调用
startTouchIDAuth(with: "请用指纹验证身份")

• 区分错误类型：不是所有错误都需要重试，比如LAErrorUserCancel（用户主动取消）、LAErrorPasscodeNotSet（未设置锁屏密码）等，这些情况应该停止重试，避免打扰用户。
• 主线程操作：所有UI相关的逻辑（包括重新发起认证）必须在主线程执行，否则可能出现弹窗不显示或崩溃的问题。
• LAContext生命周期：每次重试都要创建新的LAContext，旧实例无法修改已绑定的reason文本，这是系统框架的限制。

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