首次登录出现PlatformException(authorize_and_exchange_code_failed)的原因及修复

错误成因 #

这个错误码-3对应AppAuth库的GENERAL_ERROR_NETWORK_ERROR，本质是网络请求层面的异常，常见触发场景：

• 设备无法连接到授权服务器域名，可能是网络环境限制（比如内网拦截、VPN冲突），或是授权服务器地址配置错误
• SSL证书不被设备信任：比如使用自签证书但未安装到设备，或证书过期、域名与服务器地址不匹配
• 授权请求参数有误，导致服务器拒绝响应，比如redirect_uri、client_id和授权服务器后台配置不一致

修复方案 #

• 检查网络与服务器地址
  直接在设备浏览器中访问授权服务器的发现端点（如https://your-auth-server/.well-known/openid-configuration），确认能正常加载。如果无法访问，排查网络是否允许该域名通行，或核对配置的服务器地址是否正确。
• 处理SSL证书问题
  若使用自签证书：iOS需在设置中导入证书并开启信任；Android要将证书放入项目res/raw目录，配置network_security_config.xml允许信任该证书。若是正式证书，确认证书未过期、域名匹配，可通过本地openssl s_client -connect your-auth-server:443命令验证。
• 核对授权请求参数
  检查AuthorizationRequest中的clientId、redirectUri、issuer是否与授权服务器后台配置完全一致，尤其是redirect_uri，必须和后台登记的内容完全匹配，包括协议（http/https）、路径后缀。
• 开启debug日志定位问题
  初始化flutter_appauth时开启debug模式，获取详细请求日志：

  final appAuth = FlutterAppAuth(
    isDebug: true,
  );
  

  运行后查看控制台输出，能明确是获取发现文档失败，还是授权请求发送环节出了问题。

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