Amplify中Ionic Capacitor安卓/IOS端Cognito SSO登录失效问题问询

核心根因 #

该问题是移动端原生环境与浏览器环境的身份验证流程差异导致的，浏览器环境下跳转回同源页面后Amplify会自动完成后续令牌交换与存储写入，Capacitor安卓环境下缺少回调监听和存储适配导致流程中断。 #

具体修复步骤 #

1. 补全OAuth回调监听逻辑 #

移动端通过深度链接跳转回应用后，Amplify默认不会主动解析回调URL里的授权参数，需要手动监听深度链接事件并交给Amplify处理：

// 应用入口文件（如app.component.ts）添加如下代码
import { App, URLOpenListenerEvent } from '@capacitor/app';
import { Auth } from 'aws-amplify';

// 应用初始化阶段注册监听
App.addListener('appUrlOpen', async (event: URLOpenListenerEvent) => {
  // 替换为你自己配置的移动端OAuth回调深度链接前缀
  if (event.url.startsWith('myapp://login/callback')) {
    try {
      // 手动触发Amplify的授权响应处理，完成令牌交换和本地存储写入
      await Auth.handleAuthResponse(event.url);
      // 此处可添加登录成功后的业务逻辑，如跳转到首页
    } catch (err) {
      console.error('授权回调处理失败', err);
    }
  }
});

注意：你当前代码中Auth.federatedSignIn的then回调只会在触发跳转前执行，不会在登录完成后触发，不要在该回调中处理登录成功逻辑。

2. 适配Capacitor原生存储 #

Amplify默认使用浏览器localStorage，在安卓原生环境下可能无法正常持久化数据，需要显式指定Capacitor存储适配器：

// Amplify初始化代码调整如下
import Amplify from 'aws-amplify';
import { CapacitorStorage } from 'aws-amplify/utils/capacitor';

Amplify.configure({
  Auth: {
    // 原有Cognito、Azure AD相关配置保持不变
    region: '你的AWS区域',
    userPoolId: '你的用户池ID',
    userPoolWebClientId: '你的应用客户端ID',
    oauth: {
      domain: '你的Cognito OAuth域名',
      scope: ['openid', 'email', 'profile'],
      // 注意此处要区分端配置，安卓端用深度链接作为回调地址
      redirectSignIn: 'myapp://login/callback',
      redirectSignOut: 'myapp://logout/callback',
      responseType: 'code' // 推荐使用授权码模式，安全性更高
    }
  },
  // 关键配置：指定Capacitor存储适配器
  Storage: {
    adapter: CapacitorStorage
  }
});

3. 确认Cognito配置合规 #

登录Cognito控制台，检查对应应用客户端的OAuth设置，确保移动端的深度链接回调地址已经被加入到允许的回调URL和允许的登出URL列表中，否则会出现授权错误。 #

验证方式 #

完成上述配置后重新打包测试，登录完成跳转回应用后等待1~2秒，再调用Auth.currentAuthenticatedUser()即可正常获取用户信息，同时可以观察到本地存储已写入Cognito相关的身份凭证数据。

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