Flutter调用AWSMobileClient登录报错idToken为null回调未触发

相同代码真机运行正常、仅模拟器异常，可直接排除业务代码逻辑错误，按以下优先级排查即可：

• 本地损坏会话缓存问题
  这是该问题最高发的诱因：AWSMobileClient 启动时会优先读取本地持久化存储的历史会话，若之前登录流程异常中断、修改过Cognito用户池配置、热重载/热重启打断了登录流程，会在模拟器本地存储残缺的会话数据（仅保留refreshToken/accessToken，缺失idToken），SDK初始化时检测到无效会话直接中断后续signIn流程，既不会触发你传入的回调，也只会在底层日志抛出CognitoUserSession is not valid because idToken is null错误。
  解决操作：
  1. 先在模拟器上长按应用图标，进入应用信息页，选择「存储」-「清除所有数据」，或者直接卸载应用后重新安装运行，清空本地所有残留缓存即可恢复。
  2. 代码层面加兜底逻辑：在AWSMobileClient初始化完成后，主动调用一次全局登出清理异常缓存：

     // 安卓原生侧/Flutter 原生桥接代码里调用
     AWSMobileClient.getInstance().signOut(SignOutOptions.builder().invalidateTokens(true).build())
     

     避免后续版本迭代中热重载再次触发缓存损坏问题。
• 模拟器时间/时区校验不通过
  Cognito 下发的idToken是JWT格式，SDK本地会强校验令牌的签发时间、过期时间，安卓模拟器经常出现启动后时间同步失败的问题（时间偏差超过5分钟、时区和实际所在地不一致），会导致SDK解析令牌时直接判定无效，将idToken置为null，且该错误不会透传到signIn的业务回调中。
  解决操作：进入模拟器系统设置，找到「日期和时间」，开启「自动确定时间」「自动确定时区」开关，重启模拟器后确认状态栏显示的时间和实际时间一致，再重试登录。
• 模拟器网络代理/拦截问题
  若模拟器配置了全局代理、开启了抓包工具未安装对应根证书、自定义了私有DNS，会导致请求Cognito令牌端点时HTTPS响应被截断，返回的报文中缺失idToken字段，真机未走代理则不会出现该问题。
  解决操作：关闭模拟器的全局代理配置，移除抓包工具的证书绑定，将模拟器网络切换为和真机一致的WiFi环境，测试可正常访问公网后再重试。
• SDK架构兼容问题
  部分旧版本AWS Android SDK（版本号低于2.40.0）在x86架构的低版本安卓模拟器上存在JWT解析bug，会将合法的idToken解析为null，arm架构的真机不会触发该bug。
  解决操作：将安卓侧依赖的aws-android-sdk-mobile-client、aws-android-sdk-cognitoauth统一升级到最新稳定版；创建模拟器时选择x86_64架构、带Google Play服务、API等级30以上的系统镜像，不要使用低于API 28的老旧镜像。

调试技巧 #

如果以上步骤操作后仍未定位原因，在初始化AWSMobileClient后开启SDK全量debug日志，即可看到SDK内部的完整错误栈，不用只依赖signIn回调返回的信息：

AWSMobileClient.getInstance().setLogLevel(Log.DEBUG)

在Logcat中过滤Cognito相关TAG即可看到完整的错误触发链路。

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