Flutter中go_router处理Amplify回调查询参数路由失败问题排查

核心原因分析 #

你遇到的问题本质是应用冷启动时的路由/认证初始化顺序不匹配：

• 手动用context.go('/login-success?code=xxx&state=xxx')是在应用完全初始化（包括Amplify）后跳转，此时go_router的路由匹配、redirect逻辑都能正常工作；
• 而Amplify认证回调是直接从外部浏览器URL启动应用（冷启动），此时go_router的初始化、Amplify的认证状态判断可能存在时序问题，导致路由被错误拦截或无法匹配。

具体排查与解决步骤 #

1. 修复redirect逻辑的异步问题 #

如果你的go_router配置了redirect逻辑，大概率是冷启动时Amplify还未完成初始化，导致redirect错误触发。注意Amplify的isSignedIn()是异步方法，不能同步判断：

// 错误示例：同步判断导致状态获取错误
redirect: (context, state) {
  final isLoggedIn = Amplify.Auth.isSignedIn(); // 此处实际返回Future<bool>，直接判断会出错
  if (!isLoggedIn && state.location != '/') {
    return '/';
  }
  return null;
}

正确写法：让redirect异步执行，先确保Amplify初始化完成，同时放行/login-success路由的访问：

redirect: (context, state) async {
  // 先同步Amplify认证状态
  await Amplify.Auth.fetchAuthSession();
  final isLoggedIn = await Amplify.Auth.isSignedIn();
  
  // 仅拦截未登录用户访问非首页、非回调页的情况
  if (!isLoggedIn && state.location != '/' && state.location != '/login-success') {
    return '/';
  }
  return null;
}

注意go_router支持异步redirect，需确保使用的是较新版本的依赖。

2. 确认go_router路由配置正确性 #

确保/login-success的路由配置无参数限制，go_router默认忽略查询参数，只要路径匹配即可触发：

final router = GoRouter(
  routes: [
    GoRoute(
      path: '/',
      builder: (context, state) => const HomePage(),
    ),
    GoRoute(
      path: '/login-success',
      builder: (context, state) {
        final code = state.queryParameters['code'];
        final stateParam = state.queryParameters['state'];
        return LoginSuccessPage(code: code, state: stateParam);
      },
    ),
  ],
  // 检查错误页是否误拦截路由，避免直接返回首页
  errorBuilder: (context, state) => Scaffold(body: Center(child: Text('路由不存在: ${state.location}'))),
);

3. 检查Flutter Web的base href配置 #

打开web/index.html，确认<base href="/">配置正确，本地开发时默认使用根路径即可，若部署在子路径下需对应调整：

<base href="/">

base href错误会导致go_router无法正确解析外部URL的路径。

4. 确认Amplify回调URL配置 #

在Amplify控制台的认证模块中，确保回调URL（Callback URL）与Flutter Web运行地址完全一致，比如本地开发时为http://localhost:53231/login-success（端口号需匹配实际运行端口），不能有多余斜杠或路径错误。

5. 调整初始化顺序 #

在main函数中先完成Amplify初始化，再初始化go_router，确保冷启动时认证状态已就绪：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 先初始化Amplify
  await _configureAmplify();
  
  // 再启动应用
  runApp(MyApp(router: _createRouter()));
}

Future<void> _configureAmplify() async {
  try {
    await Amplify.addPlugin(AmplifyAuth());
    await Amplify.configure(amplifyconfig);
  } on Exception catch (e) {
    print('Amplify初始化失败: $e');
  }
}

GoRouter _createRouter() {
  return GoRouter(/* 路由配置 */);
}

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