Flutter重启时先路由到'/'，initialRoute设置未生效问题求助

问题原因 #

• Flutter的MaterialApp在初始化时，若initialRoute的求值存在异步延迟（比如从本地存储读取jwtToken是异步操作，但你在build中直接同步判断），会默认先加载'/'作为初始路由，待token加载完成后才跳转到目标页，导致'/'被压入路由栈。
• 即使修改HomeScreen.id为'/home'，若未配置'/'对应的路由规则，Flutter仍会尝试导航到'/'，而onGenerateRoute可能因找不到匹配路由触发默认逻辑，或者你的token判断逻辑在App初始化后才完成，导致先进入'/'再跳转。
• 若initialRoute的判断逻辑写在MaterialApp的build方法中，build方法的多次执行可能导致路由重复初始化，出现先跳'/'再跳转的情况。

解决方案 #

1. 启动前同步完成Token读取，直接指定初始路由 #

在main函数中先完成token的同步读取（确保App启动前就拿到token值），再初始化MaterialApp，从根源避免路由栈残留：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 从本地存储同步读取jwtToken（以shared_preferences为例）
  final prefs = await SharedPreferences.getInstance();
  final jwtToken = prefs.getString('jwt_token');
  
  // 直接传入确定的初始路由
  runApp(MyApp(initialRoute: jwtToken?.isNotEmpty == true ? '/home' : '/login'));
}

class MyApp extends StatelessWidget {
  final String initialRoute;

  const MyApp({super.key, required this.initialRoute});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: initialRoute,
      onGenerateRoute: (settings) {
        switch (settings.name) {
          case '/home':
            return MaterialPageRoute(builder: (_) => const HomeScreen());
          case '/login':
            return MaterialPageRoute(builder: (_) => const LoginScreen());
          // 处理未知路由，直接跳转登录页
          default:
            return MaterialPageRoute(builder: (_) => const LoginScreen());
        }
      },
    );
  }
}

2. 使用Navigator.pushReplacement避免路由栈残留 #

如果必须在页面初始化后判断token，在跳转目标页时使用pushReplacement替换当前路由，这样路由栈中只会保留目标页：

class HomeScreen extends StatefulWidget {
  static const id = '/home';
  const HomeScreen({super.key});

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  @override
  void initState() {
    super.initState();
    _checkAuth();
  }

  void _checkAuth() async {
    final prefs = await SharedPreferences.getInstance();
    final jwtToken = prefs.getString('jwt_token');
    if (jwtToken?.isEmpty != false) {
      // 使用pushReplacement替换当前路由，清除栈中的HomeScreen
      if (mounted) {
        Navigator.pushReplacementNamed(context, LoginScreen.id);
      }
    }
  }

  @override
  Widget build(BuildContext context) {
    return const Scaffold(body: Center(child: Text('首页')));
  }
}

3. 禁用默认的'/'路由，配置unknownRoute #

确保MaterialApp没有默认的home属性，且unknownRoute直接指向登录页，避免Flutter默认跳转'/'：

MaterialApp(
  initialRoute: jwtToken?.isNotEmpty == true ? '/home' : '/login',
  home: null, // 禁用默认home
  onGenerateRoute: (settings) {
    // 你的路由逻辑
  },
  unknownRoute: MaterialPageRoute(builder: (_) => const LoginScreen()),
);

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