AWS Amplify 在 React Native 0.77.0 中的 Auth 配置问题解析

问题背景

在使用 AWS Amplify 进行 React Native 应用开发时，开发者可能会遇到一个常见的认证配置问题：AuthUserPoolException: Auth UserPool not configured。这个问题通常出现在 React Native 0.77.0 及以上版本中，当开发者尝试使用 Amplify 的认证功能时，系统提示用户池未正确配置。

问题表现

开发者按照官方文档配置了 Amplify 的认证模块，在应用启动时调用了 Amplify.configure() 方法，传入正确的 Cognito 配置参数。通过 Amplify.getConfig() 检查配置也确实显示配置已加载。然而，在实际调用 signIn 方法时，系统却抛出用户池未配置的错误。

根本原因分析

经过深入排查，这个问题通常由以下几个因素导致：

1. 依赖管理问题：在 monorepo 项目结构中，多个 package.json 文件可能导致 aws-amplify 库被重复安装，造成版本冲突。

2. Metro 配置不当：React Native 0.77.0 引入了一些实验性功能，如 unstable_enableSymlinks 和 unstable_enablePackageExports，这些功能可能与 Amplify 的模块解析机制产生冲突。

3. 缓存问题：旧的 node_modules 和 lock 文件可能包含过时或不一致的依赖信息，影响 Amplify 的正常运行。

解决方案

1. 彻底清理项目依赖

对于使用 monorepo（如 Turborepo）的项目，需要执行以下步骤：

# 删除所有子项目的 node_modules
rm -rf packages/*/node_modules

# 删除根目录的 node_modules
rm -rf node_modules

# 删除 lock 文件
rm -rf pnpm-lock.yaml  # 或 package-lock.json/yarn.lock

# 重新安装依赖
pnpm install  # 或 npm install/yarn install

2. 优化 Metro 配置

确保 metro.config.js 配置简洁有效，避免启用实验性功能：

const path = require('path');

module.exports = {
  resolver: {
    assetExts: ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'],
    sourceExts: ['js', 'jsx', 'json', 'ts', 'tsx', 'svg'],
  },
  transformer: {
    babelTransformerPath: require.resolve('react-native-svg-transformer'),
  },
  watchFolders: [path.join(__dirname, '..', '..')],
};

3. 检查依赖冲突

确保项目中只有一个 aws-amplify 的版本，避免以下情况：

• 直接依赖和间接依赖版本不一致
• 不同子项目使用了不同版本的 Amplify
• 存在重复的 @aws-amplify/auth 等旧版包

最佳实践建议

1. 版本一致性：确保所有子项目使用相同版本的 aws-amplify 和相关依赖。

2. 配置验证：在调用认证方法前，添加配置验证逻辑：

import { Amplify } from 'aws-amplify';

const config = {
  Auth: {
    Cognito: {
      // 你的配置
    }
  }
};

try {
  Amplify.configure(config);
  console.log('Amplify 配置验证通过:', Amplify.getConfig());
} catch (error) {
  console.error('Amplify 配置失败:', error);
}

3. 渐进式升级：当升级 React Native 或 Amplify 版本时，建议：
   • 先在小范围测试认证功能
   • 逐步更新依赖版本
   • 仔细阅读版本变更日志中的破坏性变更

总结

AWS Amplify 在 React Native 0.77.0 及以上版本中出现的用户池配置问题，通常源于依赖管理和构建配置的复杂性。通过彻底清理项目依赖、优化 Metro 配置和确保依赖一致性，可以有效解决这一问题。对于大型项目，特别是使用 monorepo 架构的项目，建立规范的依赖管理流程尤为重要。

开发者应当将这类问题的解决经验纳入项目的最佳实践文档，以便团队成员在遇到类似问题时能够快速定位和解决，保证开发效率和应用稳定性。