AWS Amplify 在 React Native 中实现 Google 登录的配置指南

问题背景

在使用 AWS Amplify 为 React Native 应用配置 Google 登录功能时，开发者经常会遇到两个典型错误："oauth param not configured" 和 "InvalidAppSchemeException"。这些错误通常源于配置不完整或环境不兼容。

核心配置要求

要实现社交登录功能，AWS Amplify 需要完整的 OAuth 配置，包括以下几个关键参数：

1. domain：Cognito 用户池的域名
2. scope：请求的权限范围（如 email、openid、phone）
3. redirectSignIn 和 redirectSignOut：回调 URL
4. responseType：授权响应类型（通常为 "code"）

常见错误解决方案

错误一：OAuthNotConfigureException

这个错误表明 OAuth 配置不完整。解决方法包括：

1. 确保在 AWS Cognito 控制台中正确配置了所有必需的 OAuth 参数
2. 使用 Amplify CLI 重新导入认证配置（amplify import auth）
3. 执行 amplify push 以更新云端和本地配置

错误二：InvalidAppSchemeException

这个错误通常出现在 React Native 环境中，原因是使用了不支持的 URL 方案：

1. 在 React Native 中不能使用 http/https 方案
2. 需要使用自定义应用方案（如 myapp://）
3. 确保在 Cognito 控制台和应用配置中使用相同的方案

Expo 环境特别说明

对于使用 Expo 的开发者需要注意：

1. Expo Go 应用不支持需要原生模块的功能
2. 开发构建（Development Build）可以支持原生模块
3. 必须配置正确的应用方案（app scheme）

最佳实践建议

1. 优先使用 Amplify CLI 创建和配置认证资源，而非手动操作
2. 对于新项目，考虑使用 Amplify Gen2 体验
3. 测试时确保所有环境（开发、生产）的回调 URL 都正确配置
4. 在 React Native 中始终使用非 HTTP 的应用方案

通过遵循这些指导原则，开发者可以避免常见的配置错误，顺利实现 AWS Amplify 的社交登录功能。