Riverpod状态在页面间不持久问题排查求助

你的代码存在三个关键问题，导致用户状态无法在页面间持久化：

1. Auth Provider注解错误 #

类式AsyncNotifier必须使用大写的@Riverpod注解，而你给Auth Provider用了小写的@riverpod。小写注解是Riverpod为函数式Provider设计的，用在类式Notifier上会生成错误的Provider逻辑，直接导致状态更新和跨Provider调用失效。

修正代码：

@Riverpod(keepAlive: true) // 改为大写注解，同时添加keepAlive保持状态
class Auth extends _$Auth {
  @override
  Future<AuthModel?> build() async => null;
  
  Future<void> login(String username, String password) async {
    var dio = getDio();
    var response = await dio.post(
      '/login',
      data: {
        'username': username,
        'password': password,
      },
    );

    state = AsyncData(AuthModel.fromJson(response.data));

    ref
        .read(userProvider.notifier)
        .setUser(UserModel.fromJson(response.data['user']));
  }
}

2. User Provider的setUser方法不必要的异步声明 #

setUser内部只是同步更新state，却定义为Future<void>，容易引发调用时序问题（比如页面跳转先于状态更新完成）。

修正代码：

@Riverpod(keepAlive: true)
class User extends _$User {
  @override
  Future<UserModel?> build() async => null;

  // 去掉async，改为同步方法
  void setUser(UserModel user) {
    state = AsyncData(user);
  }

  void signOut() {
    state = const AsyncData(null);
  }
}

3. Profile页未正确处理AsyncValue状态 #

直接访问user.value会忽略AsyncValue的加载、错误状态，即使后续状态更新，也可能因未正确监听而无法刷新页面。使用when方法可以覆盖所有状态场景，确保数据更新时页面同步渲染。

修正代码：

class ProfileScreen extends ConsumerWidget {
  const ProfileScreen({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    var user = ref.watch(userProvider);
 
    return user.when(
      loading: () => const CircularProgressIndicator(),
      error: (err, stack) => Text('加载失败: $err'),
      data: (userData) => Column(
        children: [
          Text(userData?.fullName ?? '未获取到姓名'),
          Text(userData?.login ?? '未获取到账号')
        ],
      ),
    );
  }
}

额外验证点 #

如果修正后仍存在问题，可以检查：

• UserModel.fromJson(response.data['user'])是否正确解析了接口返回的用户数据，确保返回的不是null
• 确认路由跳转逻辑没有重置Provider（你的代码使用pushNamed，不存在这个问题）

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