iOS Facebook Login 接入 Firebase 是否需修改 AppDelegate?
结论
题述的默认 Flutter 工程通常不需要为 Facebook Login 单独编写 AppDelegate.swift 回调。flutter_facebook_auth 已接入 Flutter 的应用生命周期转发机制,继承 FlutterAppDelegate、注册插件并保留 super 调用,就能让插件收到相关回调。插件 iOS 配置说明
遇到这个错误,应先检查 iOS 是否返回了 Limited Login 的 ID token,而代码却把它当作普通 Facebook access token 交给了 Firebase。LoginTracking.limited 配合 idToken、rawNonce 是 Firebase 支持的登录方式,可以用于正式实现。Firebase 的 Facebook 登录文档
仅凭错误码 190 和 "Bad signature",还无法确定故障原因,需要先确认实际返回的 token 类型。
为什么没有重写 AppDelegate,也能处理回调?
Info.plist 中的 URL scheme 告诉系统哪个应用可以打开 fb<AppID> 链接。应用收到链接后,还需要把回调交给 Facebook SDK。
flutter_facebook_auth 已经实现了这部分逻辑:插件通过 registrar.addApplicationDelegate(instance) 注册生命周期代理,并在自己的 application(_:open:options:) 中调用 Facebook SDK。插件 iOS 实现
因此,下面这句判断不成立:
// No open(_:options:) override — URL callbacks are NOT intercepted here
即使子类没有重写方法,也可以使用从 FlutterAppDelegate 继承的处理逻辑。题述代码中的插件注册和 super.application(...) 应当保留。
需要检查项目是否在其他地方自定义了 URL 回调,却提前 return false,或处理完自己的链接后没有继续调用 super。如果已有这个 override,应继续转发未处理的链接:
override func application(
_ app: UIApplication,
open url: URL,
options: [UIApplication.OpenURLOptionsKey: Any] = [:]
) -> Bool {
// 如有自定义链接处理,在这里处理并返回结果。
return super.application(app, open: url, options: options)
}
默认工程无需专门添加这段代码。如果工程自行引入了 SceneDelegate,或更改了生命周期结构,应按实际使用的插件版本检查回调路径。
Android 使用 Manifest 中的 Activity、intent filter 等配置参与回跳处理,两端也都有 SDK 和插件负责原生工作。因此,不能从“Android 没写原生代码”推导出“iOS 必须手写 AppDelegate”。
更可能的原因:两种 token 被混用了
result.accessToken 是插件统一使用的属性名,其中的值不一定是经典 OAuth access token。插件从 7.0.0 起区分 ClassicToken 和 LimitedToken,并说明 iOS 的跟踪授权状态可能使登录进入 Limited Login。插件变更记录
两种返回值需要分别处理:
| 返回类型 | tokenString 的含义 |
Firebase 接法 |
|---|---|---|
ClassicToken |
Facebook OAuth access token | FacebookAuthProvider.credential(...) |
LimitedToken |
Facebook OIDC ID token | OAuthProvider('facebook.com').credential(idToken: ..., rawNonce: ...) |
原来的代码:
FacebookAuthProvider.credential(result.accessToken!.tokenString);
适用于 ClassicToken。如果 iOS 返回的是 LimitedToken,这行代码就会把 ID token 交给 access token 验证流程。Android 返回经典 token 时,同样的 Dart 代码可以正常运行。
排查时先查看 result.accessToken?.type 或实际对象类型,不需要输出完整 token。如果返回的是 LimitedToken,就能确认原实现中的 token 类型与 credential 接口不匹配。
Limited Login 配合 nonce 应该怎样写?
如果 iOS 只需要通过 Facebook 登录 Firebase,可以显式选择 Limited Login,同时保留 Android 的经典登录流程。
下面的示例适用于 Flutter iOS、Android 原生应用,需要添加 crypto 依赖:
import 'dart:convert';
import 'dart:io';
import 'dart:math';
import 'package:crypto/crypto.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter_facebook_auth/flutter_facebook_auth.dart';
String generateNonce([int length = 32]) {
const charset =
'0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._';
final random = Random.secure();
return List.generate(
length,
(_) => charset[random.nextInt(charset.length)],
).join();
}
String sha256ofString(String input) {
return sha256.convert(utf8.encode(input)).toString();
}
Future<UserCredential?> signInWithFacebook() async {
final rawNonce = generateNonce();
final LoginResult result;
if (Platform.isIOS) {
result = await FacebookAuth.instance.login(
permissions: ['email', 'public_profile'],
loginTracking: LoginTracking.limited,
nonce: sha256ofString(rawNonce),
);
} else {
result = await FacebookAuth.instance.login(
permissions: ['email', 'public_profile'],
);
}
if (result.status == LoginStatus.cancelled) {
return null;
}
if (result.status != LoginStatus.success) {
throw StateError(result.message ?? 'Facebook login failed');
}
final token = result.accessToken;
if (token == null) {
throw StateError('Facebook login succeeded without a token');
}
final OAuthCredential credential;
if (token is LimitedToken) {
credential = OAuthProvider('facebook.com').credential(
idToken: token.tokenString,
rawNonce: rawNonce,
);
} else {
credential = FacebookAuthProvider.credential(token.tokenString);
}
return FirebaseAuth.instance.signInWithCredential(credential);
}
OAuthProvider.credential 支持 idToken 和 rawNonce 参数,无需手动填写 signInMethod。FlutterFire API
nonce 必须对应同一次登录请求:
- 为每次登录生成新的随机
rawNonce。 - 把
SHA-256(rawNonce)传给 Facebook 的nonce参数。 - 把原始
rawNonce与返回的 ID token 一起交给 Firebase。
Firebase 文档说明,这一对应关系用于将响应绑定到登录请求,防止重放攻击。传给 rawNonce 的必须是原始值,不能使用哈希后的值,也不能在收到响应后重新生成 nonce。Firebase Limited Login 接入步骤
这是否绕过了 URL scheme?
Limited Login 改变了登录模式和返回的凭据类型,不能理解为“完全绕过 URL scheme 重定向”。插件要求的 iOS 配置仍需保留;如果自定义生命周期代码吞掉了回调,Limited Login 也无法修复。URL scheme、Facebook 配置项和插件回调链路都应配置正确。
是否采用 Limited Login,取决于业务需要。只做身份登录时,它可以作为正式方案;如果还需要调用 Facebook Graph API,就要另行确认所需权限与登录模式。Limited Login 的 ID token 不能直接用作 Graph API access token。插件的 token 使用说明
错误 190 是否说明回调把 token 弄坏了?
没有证据支持“回调未完成,导致 Facebook 返回半截 token”这一解释。
题述流程已经获得 LoginStatus.success,并进入 Firebase 的 signInWithCredential,应先排查凭据类型和验证配置。回调丢失通常会直接表现为登录无法完成或无法返回结果,具体仍需结合实际日志判断。
190 / Bad signature 表示提交的凭据未通过相应流程的验证,不能据此断言 Firebase 正在“用 App Secret 验证一个被截断的 token”。对于 Limited Login,应使用 ID token 与 nonce 对应的认证流程。
如果确认返回的是 ClassicToken,仍出现同样错误,再按顺序核对:
- Firebase 是否启用了 Facebook 登录,配置的 App ID、App Secret 是否属于当前 Facebook 应用。
Info.plist的FacebookAppID、fb<AppID>和 Meta 后台的 iOS Bundle ID 是否一致。- 是否混用了开发环境、生产环境或不同 Facebook 应用的配置。
- token 在传给 Firebase 前,是否被业务代码替换、截断或错误编码。
FacebookClientToken 与 App Secret 是不同配置,不能互相替代。App Secret 应配置在 Firebase 等可信服务端,不能放进客户端。如果已有 CFBundleURLTypes、LSApplicationQueriesSchemes,应合并数组,避免重复声明同名键。Firebase 配置要求、插件 Info.plist 配置说明
^7.1.2 和 ^6.1.4 是版本约束,定位问题时应以 pubspec.lock 和 iOS 原生依赖锁文件中的实际版本为准。当前错误发生在 Firebase 登录阶段;如果此时尚未请求 Magento 2,应先排查客户端到 Firebase 这一段。
备注:内容仅供参考。
