在 Amplify 升级至 v6 后，将 Auth、API 等功能抽离为跨平台（Web + React Native）私有 Node 模块时，常因配置未显式注入导致 AuthUserPoolException: Auth UserPool not configured 错误；本文提供兼容 v6 的标准化配置方案。
在 amplify 升级至 v6 后，将 auth、api 等功能抽离为跨平台（web + react native）私有 node 模块时，常因配置未显式注入导致 `authuserpoolexception: auth userpool not configured` 错误；本文提供兼容 v6 的标准化配置方案。
Amplify v6 引入了更严格的配置隔离机制：配置不再自动继承或跨模块透传。此前 v5 中，主应用调用 Amplify.configure() 后，其子模块可能隐式复用该配置；但 v6 将配置绑定到模块作用域，若私有工具模块（如 @me/my-module）自身未完成初始化，则无法访问 Cognito User Pool、GraphQL API 等核心服务——这正是 AuthUserPoolException 的根本原因。
✅ 正确做法是：由共享模块主动接管 Amplify 初始化，而非依赖宿主应用传递配置。具体步骤如下：
-
将
amplifyconfiguration.json放入模块内部（建议置于src/下），确保模块具备完整配置上下文； - 在模块中封装显式配置函数，避免副作用并支持按需触发：
// @me/my-module/src/amplify/setup.ts
import { Amplify } from 'aws-amplify';
import amplifyconfig from './amplifyconfiguration.json';
export const setupCommonAmplifyModule = (): void => {
// ⚠️ 关键：必须在此处调用 configure，且仅执行一次
if (!Amplify.getConfig()) {
Amplify.configure(amplifyconfig);
}
// 验证配置生效
const config = Amplify.getConfig();
console.log('[COMMON MODULE] Amplify configured:', {
auth: !!config.Auth,
api: !!config.API?.GraphQL?.endpoint
});
};
- 宿主应用（Web / React Native）移除重复配置，仅调用模块初始化函数：
// web-app/src/index.tsx
import { setupCommonAmplifyModule } from '@me/my-module';
// ✅ 替代原来的 Amplify.configure(...)
setupCommonAmplifyModule();
// 后续可安全使用模块内封装的 auth/API 工具
import { signIn, fetchUserData } from '@me/my-module';
? 注意事项：
- ❌ 不要在多个位置重复调用
Amplify.configure()（v6 会抛出警告并覆盖配置）； - ✅ 使用
Amplify.getConfig()判断是否已配置，增强健壮性； - ? 若模块需支持 SSR（如 Next.js），请确保
setupCommonAmplifyModule()仅在客户端执行（例如包裹在useEffect或if (typeof window !== 'undefined')中）； - ? React Native 项目仍“看似正常”，实则因旧版缓存或初始化时机巧合暂未暴露问题，务必统一迁移，避免后续版本升级引发崩溃。
通过此方案，您既能保持 Web 与 React Native 共享同一套 Amplify 业务逻辑，又完全符合 Amplify v6 的配置契约——真正实现“一处配置、多端复用”的工程目标。
