AWS Amplify JS 在 Monorepo 中 React Native 登录问题的分析与解决方案

问题背景

在使用 AWS Amplify JS v6 构建的 Turbo monorepo 项目中，开发团队遇到了一个特殊的身份验证问题。项目包含 React Web 应用和 React Native 移动应用，两者都使用了 Amplify 的认证服务。有趣的是，Web 应用能够正常使用邮箱密码登录功能，而 React Native 应用却抛出"Auth UserPool not configured"错误。

问题现象

当 React Native 应用尝试通过邮箱和密码登录时，系统会抛出以下错误：

[AuthUserPoolException: Auth UserPool not configured.]

问题根源分析

经过深入排查，发现问题出在 TokenStore.js 文件中。在 React Native 环境下，this.authConfig 对象未被正确初始化，导致无法获取用户池配置信息。核心问题在于：

1. 在 monorepo 架构下，React Native 应用未能正确继承或访问 Amplify 的全局配置
2. TokenStore 类在获取认证密钥时，没有正确处理配置信息
3. 默认情况下，代码假设 authConfig 已经存在，这在 React Native 环境中不成立

解决方案

团队通过 patch-package 创建了一个补丁文件，修改了 TokenStore.js 的核心逻辑。关键修改点包括：

1. 显式引入 @aws-amplify/core 模块
2. 直接从 Amplify 全局配置中获取 Auth 配置
3. 确保在获取认证密钥前正确设置 authConfig

补丁的核心代码如下：

const core_1 = require("@aws-amplify/core");
// ...
async getAuthKeys(username) {
    const authConfig = core_1.Amplify.getConfig().Auth;
    (0, utils_1.assertTokenProviderConfig)(authConfig.Cognito);
    this.setAuthConfig(authConfig);
    const lastAuthUser = username ?? (await this.getLastAuthUser());
    return (0, exports.createKeysForAuthStorage)(this.name, `${authConfig.Cognito.userPoolClientId}.${lastAuthUser}`);
}

最佳实践建议

对于在 monorepo 中使用 AWS Amplify 的开发者，建议：

1. 确保所有子项目使用相同版本的 Amplify 相关依赖
2. 在每个子项目中独立配置 Amplify，不要依赖全局配置
3. 在 React Native 项目中，特别注意异步初始化顺序
4. 考虑使用依赖管理工具检查依赖树的一致性
5. 对于关键功能，添加配置验证逻辑

总结

这个案例展示了在复杂项目架构中，配置管理可能面临的挑战。通过深入理解 Amplify 的内部工作机制，开发团队能够定位并解决问题。这也提醒我们，在 monorepo 架构中，需要特别注意模块间的配置共享和隔离问题。