如何在 Flet 应用中实现实时页面状态同步（跨客户端更新）

本文详解如何解决 flet 多用户场景下页面状态不同步问题，通过共享状态管理、避免阻塞式轮询、合理调用 page.update() 并结合 page.clean() 重载机制，实现无需刷新的实时视图更新。

在 Flet 开发中，一个常见误区是将“页面更新”简单等同于反复调用 page.update()。正如示例所示：当多个用户访问同一应用时，每个会话（page 实例）独立运行，彼此隔离。即使共享文件（如 "views"）存储计数器，各客户端仍只在自身路由变更时读取一次初始值并静态渲染——导致用户 A 看到 Views: 1，用户 B 切换后变为 Views: 2，但 A 的界面不会自动刷新，因为 Flet 默认不主动推送服务端状态变更。

根本原因在于：Flet 是单向响应式框架，UI 更新需显式触发，且 page.update() 仅作用于当前会话。试图用 while True: page.update() 实现“实时轮询”会阻塞主线程，使事件循环瘫痪，页面失去交互能力（点击无响应），这是绝对不可取的反模式。

✅ 正确解法不是轮询，而是按需重载 + 状态中心化 + 原子化更新：

1. 确保每次路由变更都重新读取最新状态（而非仅初始化时读取）；
2. 清除旧 UI 并重建最新内容，避免残留陈旧控件；
3. 将状态持久化与 UI 渲染解耦，保证数据一致性。

以下是优化后的完整实现：

标贝科技

标贝科技-专业AI语音服务的人工智能开放平台

import flet as ft

def main(page: ft.Page):
    # 初始化：从文件读取当前计数（注意异常处理）
    try:
        with open("views", "r") as f:
            views_count = int(f.read().strip())
    except (FileNotFoundError, ValueError):
        views_count = 0

    def route_change(e: ft.RouteChangeEvent):
        nonlocal views_count
        # 1. 每次路由变化前，先确保读取最新计数值（关键！）
        try:
            with open("views", "r") as f:
                views_count = int(f.read().strip())
        except (FileNotFoundError, ValueError):
            views_count = 0

        # 2. 构建最新 UI（基于当前最新值）
        views_text = ft.Text(f"Views: {views_count + 1}")
        views_container = ft.Container(views_text)

        # 3. 清空当前页面，避免旧控件残留
        page.clean()

        # 4. 添加新控件
        page.add(views_container)

        # 5. 更新计数并持久化（原子操作建议加锁，生产环境需考虑并发）
        views_count += 1
        with open("views", "w") as f:
            f.write(str(views_count))

        # 6. 最终触发本次会话的 UI 更新
        page.update()

    # 绑定路由事件处理器
    page.on_route_change = route_change
    page.go("/")  # 触发首次加载

⚠️ 重要注意事项：

• 文件 I/O 非线程安全：多用户并发写入 "views" 文件可能导致数据竞争或覆盖。生产环境应改用线程安全的存储（如 SQLite、Redis）或引入文件锁（threading.Lock 或 portalocker）；
• nonlocal 替代 global：在嵌套函数中修改外层变量更符合 Python 最佳实践；
• 资源管理优先使用 with：确保文件句柄自动关闭，避免泄漏；
• page.clean() 不可省略：它清除了当前会话所有控件，是实现“动态重载”的基础步骤；
• page.update() 仅对当前会话生效：Flet 尚未原生支持服务端向多客户端广播（类似 WebSocket 推送），如需真正实时同步（如用户 A 计数+1 后用户 B 界面自动刷新），需自行集成后端消息队列或长连接方案（如 FastAPI + WebSockets + 客户端 JS 监听）。

总结：Flet 的“实时同步”本质是每个客户端在关键交互点（如路由跳转、按钮点击）主动拉取最新状态并重绘。理解其单页应用（SPA）模型与会话隔离特性，摒弃阻塞轮询，采用 clean() → rebuild → update() 流程，即可稳健实现跨用户状态可见性。