Flutter认证成功后无法跳转至HomePage问题排查求助

以下是导致认证后页面未跳转的核心原因及对应解决办法：

1. FutureBuilder仅执行一次，无法监听后续状态变化 #

你的AuthOrHomePage通过FutureBuilder处理自动登录逻辑，但FutureBuilder的future执行完成后，不会主动触发builder重建。后续authController.isAuth变为true时，FutureBuilder不会重新执行判断逻辑，自然不会切换到HomePage。

解决办法：
移除FutureBuilder，改用Consumer或将组件改为StatefulWidget，在初始化阶段执行自动登录，同时监听AuthController的状态变化：

class AuthOrHomePage extends StatefulWidget {
  const AuthOrHomePage({Key? key}) : super(key: key);

  @override
  State<AuthOrHomePage> createState() => _AuthOrHomePageState();
}

class _AuthOrHomePageState extends State<AuthOrHomePage> {
  bool _isLoading = true;

  @override
  void initState() {
    super.initState();
    // 初始化时执行自动登录
    Provider.of<AuthController>(context, listen: false)
        .tryAutoLogin()
        .then((_) => setState(() => _isLoading = false))
        .catchError((_) => setState(() => _isLoading = false));
  }

  @override
  Widget build(BuildContext context) {
    final authController = Provider.of<AuthController>(context);

    if (_isLoading) {
      return const Center(child: CircularProgressIndicator());
    } else if (authController.hasError) { // 建议给AuthController添加错误状态字段
      return const Center(child: Text('Ocorreu um erro!'));
    } else {
      return authController.isAuth ? const HomePage() : const InitPage();
    }
  }
}

2. AuthController未实现状态通知机制 #

如果AuthController没有继承ChangeNotifier（或其他可监听的Provider基类），或者在更新isAuth时未调用notifyListeners()，即使isAuth变为true，Provider也无法通知依赖的组件重建页面。

检查AuthController代码，确保：

• 继承ChangeNotifier并在状态变更时触发通知：

class AuthController extends ChangeNotifier {
  bool _isAuth = false;
  bool get isAuth => _isAuth;
  bool hasError = false;

  Future<void> tryAutoLogin() async {
    try {
      // 自动登录逻辑实现
      _isAuth = true;
      hasError = false;
    } catch (_) {
      hasError = true;
    }
    notifyListeners(); // 必须调用此方法通知状态变化
  }
}

3. Provider监听配置错误 #

若获取AuthController时设置了listen: false，组件将无法监听状态变化。你的代码中Provider.of(context)默认listen: true，这一点没问题，但如果后续修改时误加listen: false，会导致无法感知isAuth的变化。

如需更安全的监听方式，推荐使用Consumer组件：

Consumer<AuthController>(
  builder: (ctx, auth, child) {
    if (_isLoading) {
      return const Center(child: CircularProgressIndicator());
    } else if (auth.hasError) {
      return const Center(child: Text('Ocorreu um erro!'));
    } else {
      return auth.isAuth ? const HomePage() : const InitPage();
    }
  },
)

内容的提问来源于stack exchange，提问作者Rafael Schaffer Gimenes