Flutter路由报错：无法找到/signup路由生成器求助

1. 检查路由表配置位置 #

确保路由表是配置在MaterialApp/CupertinoApp的routes参数中，而非WidgetsApp（报错提到的_WidgetsAppState说明可能误用了根组件）。正确配置示例：

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '应用名称',
      initialRoute: '/login',
      routes: {
        '/login': (context) => const LoginScreen(),
        '/signup': (context) => const SignUpScreen(), // 确认路由名和跳转时完全一致
      },
    );
  }
}

如果必须用WidgetsApp，需手动指定onGenerateRoute参数——WidgetsApp默认没有内置路由生成器，而MaterialApp已封装该逻辑。

2. 确认上下文(context)有效性 #

跳转时使用的context必须是MaterialApp/CupertinoApp子树内的上下文，不能是根组件的context。比如LoginScreen若直接在MaterialApp的routes中配置，按钮的context没问题；但如果是在MaterialApp外的组件调用跳转，就会找不到路由表。

错误示例（context不在MaterialApp子树）：

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: ElevatedButton(
          onPressed: () {
            // 此处context属于MyApp，不在MaterialApp子树内，会报错
            Navigator.of(context).pushNamed('/signup');
          },
          child: const Text('Регистрация'),
        ),
      ),
    );
  }
}

解决方法：用Builder包裹按钮，获取子树的context：

Builder(
  builder: (context) {
    return ElevatedButton(
      onPressed: () {
        Navigator.of(context).pushNamed('/signup');
      },
      child: const Text('Регистрация'),
    );
  },
)

3. 核对路由名拼写 #

确认跳转时的'/signup'和路由表中的键完全一致，大小写、斜杠都不能出错（比如别写成'/SignUp'或'signup'）。

4. 手动配置onGenerateRoute兜底 #

若上述方法无效，可手动配置onGenerateRoute确保路由匹配：

MaterialApp(
  initialRoute: '/login',
  onGenerateRoute: (settings) {
    switch (settings.name) {
      case '/login':
        return MaterialPageRoute(builder: (context) => const LoginScreen());
      case '/signup':
        return MaterialPageRoute(builder: (context) => const SignUpScreen());
      default:
        return MaterialPageRoute(builder: (context) => const NotFoundScreen());
    }
  },
)

5. 清理缓存重启项目 #

Flutter热重载可能存在缓存问题，执行flutter clean后重启项目，再测试跳转是否正常。

内容的提问来源于stack exchange，提问作者Ильяс Нигматов