将现有Amplify应用切换至新仓库后Cognito注册遇AuthError求助

问题描述 #

通过创建新Amplify应用并一对一复制所有设置，将现有Amplify应用切换到新仓库后，AWS Cognito注册流程触发如下错误，其他功能正常，旧项目无此问题：

AuthError -
Error: Amplify has not been configured correctly.
The configuration object is missing required auth properties.
This error is typically caused by one of the following scenarios:

1. Did you run `amplify push` after adding auth via `amplify add auth`?
            See https://aws-amplify.github.io/docs/js/authentication#amplify-project-setup for more information

        2. This could also be caused by multiple conflicting versions of amplify packages, see (https://docs.amplify.aws/lib/troubleshooting/upgrading/q/platform/js) for help upgrading Amplify packages.

排查与解决步骤 #

1. 确认Amplify配置文件完整性 #

• 检查新仓库中aws-exports.js（前端项目）或amplifyconfiguration.json（移动端）文件，对比旧项目对应文件，确保Auth模块的所有配置项完整，包括Cognito用户池ID、客户端ID、区域等核心字段，无遗漏或拼写错误。
• 若手动复制配置文件，大概率存在复制不全的情况，建议直接用旧项目的完整配置文件覆盖新仓库对应文件。

2. 验证Amplify环境部署状态 #

• 在新仓库本地环境执行amplify status，确认Auth模块状态为Deployed；若显示未部署，重新执行amplify push完成部署。
• 登录AWS控制台检查Amplify应用的Auth模块配置，确保和旧项目的Cognito用户池、客户端设置完全一致，包括用户池属性、触发Lambda、客户端权限等细节。

3. 清理并统一Amplify依赖版本 #

• 删除项目的node_modules文件夹和package-lock.json/yarn.lock文件，重新安装依赖。
• 确保package.json中所有Amplify相关包（如aws-amplify、@aws-amplify/ui-react等）的版本和旧项目完全一致，避免版本冲突。
• 安装完成后执行npm ls aws-amplify（或yarn对应命令），检查是否存在多版本Amplify包，如有则手动调整依赖版本统一。

4. 检查前端初始化代码 #

• 确认前端项目中Amplify初始化代码正确，且在调用Auth相关方法前已完成配置加载，示例：

import Amplify from 'aws-amplify';
import awsExports from './aws-exports';

Amplify.configure(awsExports);
// 确保在调用Auth.signUp等方法前执行上述配置

• 避免在异步加载配置时提前调用Auth功能，导致配置未就绪就触发请求。

5. 重置Amplify本地环境 #

• 执行amplify env remove删除新仓库的本地环境，然后重新执行amplify pull从云端拉取完整配置，确保本地环境与云端完全同步。

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