Flutter Web接入Sign in with Apple返回未知异常且无弹窗如何解决

报错字段说明 #

你遇到的Unexpected null value和email字段无关，该错误出现在Apple授权弹窗触发前的前置校验环节，是Firebase Auth SDK调用signInWithPopup时获取OAuth配置元数据失败返回空值导致的，流程根本没有走到向Apple发起授权请求的步骤，所以不会弹出授权窗口。

可能的问题原因 #

• Firebase控制台Apple登录配置缺失/错误
  Web端使用Apple登录需要同时在Firebase控制台和Apple开发者后台完成双向配置：
  1. Firebase控制台Authentication的登录方法页开启Apple登录后，需要正确填入Apple开发者后台生成的团队ID、服务ID、密钥ID、私钥内容
  2. 必须将Firebase Apple登录配置页给出的重定向回调URL，完整添加到Apple开发者后台对应服务ID的返回URL列表中
• 测试域名未加入Firebase授权列表
  Firebase默认只允许白名单内的域名发起Auth请求，你需要在Firebase控制台Authentication→设置→授权域名中，添加当前测试用的域名（比如本地测试的localhost:端口号、线上部署的域名）
• 测试环境限制
  1. Chrome开启了弹窗拦截，会直接阻止Firebase弹出授权窗口
  2. 使用无痕模式测试时，第三方弹窗的权限默认被限制
  3. Flutter Web默认CanvasKit渲染器可能存在跨域限制，影响授权流程触发
• 依赖与初始化问题
  1. firebase_core、firebase_auth版本过低，存在已知的Web端Apple登录兼容问题
  2. 项目未正确完成Firebase初始化，或者Web端index.html中的Firebase配置参数缺失

排查步骤 #

1. 优先核对Firebase和Apple开发者后台的双向配置，确保重定向URL、服务ID等核心参数完全匹配
2. 检查授权域名列表，添加当前测试所用的所有域名
3. 关闭Chrome弹窗拦截，使用普通窗口测试，运行项目时添加参数flutter run -d chrome --web-renderer html
4. 升级firebase相关依赖到最新稳定版，确认main.dart中已经在runApp前执行了await Firebase.initializeApp()

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