Flutter中SharedPreferences结合FutureBuilder为何同时返回两种状态

• FutureBuilder的future参数在build方法中直接赋值为init()/SharedPreferences.getInstance()的返回值，每次Widget重建都会重新创建新的Future实例
  每次build触发时，新的Future被绑定到FutureBuilder的瞬间，会先处于ConnectionState.waiting状态，此时hasData为false，会走else分支打印"No Preference Data"。由于SharedPreferences.getInstance()内部自带缓存，新的Future会立刻拿到已缓存的实例，状态切为done，hasData变为true，又会走if分支拿到有效user值，最终就出现"既拿到有效值又打印提示"的矛盾现象。
• 快照判断逻辑错误
  你直接用hasData判断是否有数据，忽略了hasData为false包含「正在加载中」「加载出错」两种情况，把正常的加载等待误判为"没有偏好数据"。
• 在builder回调中做副作用赋值
  FutureBuilder的builder方法会在Widget重建时多次调用，直接修改外部user变量属于Flutter反模式，容易引发状态混乱。

1. 缓存Future实例，避免重复创建 #

FutureBuilder的future参数必须提前创建、全局复用，绝对不能在build方法中动态生成。最常规的做法是在StatefulWidget的initState中初始化Future，存储为State成员变量，后续build直接复用。

2. 优化快照判断逻辑 #

先判断connectionState是否为ConnectionState.done，只有加载完全结束后，再区分处理「有数据」「加载出错」两种情况，不要把加载中状态当成无数据。

3. 避免在builder中做副作用 #

如果只是需要展示用户信息，直接在builder拿到数据后返回对应Widget即可，不需要修改外部全局变量；如果确实需要存储user值，仅在快照为done且有数据时赋值一次。

class UserInfoWidget extends StatefulWidget {
  const UserInfoWidget({super.key});

  @override
  State<UserInfoWidget> createState() => _UserInfoWidgetState();
}

class _UserInfoWidgetState extends State<UserInfoWidget> {
  // 仅初始化一次的Future实例
  late final Future<SharedPreferences> _initFuture;
  String user = "";

  @override
  void initState() {
    super.initState();
    // 只调用一次init，后续重建复用这个Future
    _initFuture = init();
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<SharedPreferences>(
      future: _initFuture,
      builder: (context, snapshot) {
        // 先判断是否加载完成
        if (snapshot.connectionState == ConnectionState.done) {
          if (snapshot.hasData) {
            // 加载成功才处理数据
            user = snapshot.data!.getString('user') ?? "";
          } else if (snapshot.hasError) {
            // 仅加载出错时打印日志
            print("加载本地存储失败: ${snapshot.error}");
            user = "";
          }
        } else {
          // 加载中状态，展示加载组件即可，不要打印无数据提示
          user = "";
        }
        // 后续返回你的业务Widget，比如：
        return Text(user.isEmpty ? "加载中..." : user);
      },
    );
  }
}

如果你使用StatelessWidget实现该逻辑，可以借助状态管理或者将Future提升到父级State中缓存，核心原则都是避免在build方法中动态生成Future。另外SharedPreferences.getInstance()本身为全局缓存实例，不需要多次调用，全局复用即可。

内容的提问来源于stack exchange，提问作者WKT - Always learning