Flutter 如何实现每次打开页面Widget时均生成全新实例而非保留旧会话信息

Flutter 出现页面返回后保留所有旧信息的情况，本质是页面实例没有被从组件树中销毁，常见触发点包括：

• 页面 State 混入了 AutomaticKeepAliveClientMixin 且 wantKeepAlive 返回 true，被框架标记为常驻保留
• 页面被放入 IndexedStack、Stack 这类常驻组件容器，不会随页面切换被销毁回收
• 路由框架手动缓存了已生成的页面实例，每次导航到该路由时直接复用缓存对象，不重新构建

1. 移除框架自带的状态保留标记 #

这是最普遍的触发原因，很多开发者为了保存列表滑动位置引入的 Mixin，没调整返回值就会一直留存页面状态：

• 检查目标页面的 State 类，删除 with AutomaticKeepAliveClientMixin 相关逻辑
• 如果必须使用该 Mixin，将 wantKeepAlive 的返回值改为 false，取消框架的常驻标记
• 检查是否有手动调用 PageStorage 写入页面状态的逻辑，移除对应代码，避免状态被全局留存

2. 适配底部导航/常驻容器的重建逻辑 #

如果是用底部导航栏切换页面的场景，IndexedStack 默认会持有所有子页面的实例，从不会自动销毁，要实现切回页面就全新加载：

• 不要在成员变量里提前实例化所有子页面存在列表里，避免永远复用旧实例
• 调整 IndexedStack 的子节点生成逻辑，仅在当前选中的索引位置构造对应页面，其他位置放占位组件，这样每次切回对应 tab 时，都会生成全新的页面实例

举个可直接参考的代码片段：

// 会触发状态保留的错误写法：提前实例化所有页面，全程复用旧对象
final pageList = [HomePage(), CartPage(), MinePage()];
IndexedStack(
  index: currentTabIndex,
  children: pageList,
);

// 可实现全新构建的正确写法
IndexedStack(
  index: currentTabIndex,
  children: [
    currentTabIndex == 0 ? const HomePage() : const SizedBox.shrink(),
    currentTabIndex == 1 ? const CartPage() : const SizedBox.shrink(),
    currentTabIndex == 2 ? const MinePage() : const SizedBox.shrink(),
  ],
)

3. 调整路由导航的缓存配置 #

如果是通过 Navigator.push 跳转、pop 返回后再次进入页面还是留存旧状态，检查路由的生成逻辑：

• 系统自带的 MaterialPageRoute 不要在 builder 回调外提前实例化页面对象，每次都在 builder 内部构造全新的页面实例
• 如果使用了第三方路由框架（如 GetX、GoRouter），找到对应路由的配置项，关闭页面持久化、重复实例复用、路由缓存类的开关，确保每次导航到该路由时都会重新执行 builder 生成全新的 Widget 树

4. 生命周期回调兜底重置 #

如果受业务逻辑限制，没法直接销毁旧的页面实例，可以借助路由监听主动清空状态：

• 注册全局的 RouteObserver，监听目标页面的可见性回调
• 在 didPopNext 钩子（即用户从其他页面返回、重新显示当前页面时）触发逻辑，把页面里所有的状态变量重置为初始值，同步清空文本控制器、滚动控制器偏移、列表缓存等所有临时数据

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