Rust egui/eframe中如何从其他线程更新应用字段并刷新界面

问题描述 #

需求为在独立线程中运行业务逻辑，每秒更新一次应用字段并同步刷新对应窗口。初始实现使用Arc<Mutex<MyApp>>包裹整个应用实例做跨线程共享，编译时抛出如下错误：

error[E0277]: the trait bound `MutexGuard<'_, MyApp>: App` is not satisfied
  --> src/main.rs:22:29
   |
22 |         Box::new(move |_cc| Box::new(arc.lock().unwrap())),
   |                             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ the trait `App` is not implemented for `MutexGuard<'_, MyApp>`
   |
   = note: required for the cast to the object type `dyn App`

For more information about this error, try `rustc --explain E0277`.

初始错误代码如下：

#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")] // hide console window on Windows in release

use std::{
    sync::{Arc, Mutex},
    thread,
    time::Duration,
};

use eframe::egui::{self};

fn main() {
    let options = eframe::NativeOptions::default();
    let app = MyApp::default();
    let arc = Arc::new(Mutex::new(app));
    thread::spawn(|| {
        thread::sleep(Duration::from_secs(1));
        arc.lock().unwrap().field += 1;
    });
    eframe::run_native(
        "Test",
        options,
        Box::new(move |_cc| Box::new(arc.lock().unwrap())),
    );
}

struct MyApp {
    field: i128,
}

impl Default for MyApp {
    fn default() -> Self {
        Self { field: 0 }
    }
}

impl eframe::App for MyApp {
    fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) {
        egui::CentralPanel::default().show(ctx, |ui| ui.label(format!("{}", self.field)));
    }
}

错误原因 #

1. 类型不匹配：eframe::run_native要求创建闭包返回拥有所有权、实现了eframe::App trait的实例，而代码中返回的是MutexGuard<MyApp>——互斥锁的守卫类型本身没有实现App trait，无法强转为dyn App trait对象。
2. 设计逻辑错误：eframe/egui的App实例设计上由UI主线程独占访问，不应该把整个App实例放到互斥锁里跨线程共享，跨线程共享的只应该是需要后台更新的业务数据本身。
3. 缺少重绘触发：就算绕过编译错误，egui默认是事件驱动重绘，没有鼠标、键盘等输入事件时不会主动刷新界面，后台改完数据不主动触发重绘的话，界面不会更新显示新值。

正确实现方案 #

核心思路：

• 仅将需要后台更新的字段用Arc<Mutex<T>>包裹，不要包裹整个App实例
• App实例持有共享数据的Arc克隆，UI绘制时短暂加锁读取值
• 后台线程更新完数据后，通过提前克隆的egui上下文调用request_repaint()主动触发界面重绘

可直接运行的正确代码：

#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")] // release模式下隐藏Windows控制台窗口

use std::{
    sync::{Arc, Mutex},
    thread,
    time::Duration,
};

use eframe::egui;

fn main() {
    let options = eframe::NativeOptions::default();
    eframe::run_native(
        "Test",
        options,
        Box::new(|cc| {
            // 仅包裹需要跨线程更新的字段，不要包裹整个App
            let shared_counter = Arc::new(Mutex::new(0i128));
            // 克隆Arc给后台线程使用
            let counter_for_thread = shared_counter.clone();
            // 克隆egui上下文，用于后台线程触发重绘
            let ctx = cc.egui_ctx.clone();

            // 启动后台计数线程
            thread::spawn(move || loop {
                thread::sleep(Duration::from_secs(1));
                *counter_for_thread.lock().unwrap() += 1;
                // 数据更新后主动请求重绘，否则界面不会自动刷新
                ctx.request_repaint();
            });

            // 返回App实例，持有共享数据的引用
            Box::new(MyApp {
                counter: shared_counter
            })
        }),
    );
}

struct MyApp {
    counter: Arc<Mutex<i128>>,
}

impl eframe::App for MyApp {
    fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) {
        // 加锁读取最新值，读完立刻释放锁，不要持锁做UI操作避免卡顿
        let current_val = *self.counter.lock().unwrap();
        egui::CentralPanel::default().show(ctx, |ui| {
            ui.label(format!("当前计数: {}", current_val));
        });
    }
}

注意事项 #

• 不要长时间持有互斥锁：UI线程读数据时拿到值就立刻释放锁，不要在锁的保护范围内做UI构建、渲染等耗时操作，避免和后台线程抢锁造成界面卡顿。
• 不要跨线程传递egui::Context以外的UI对象：egui大部分UI类型都不是线程安全的，只有Context支持跨线程克隆传递。
• 如果需要更高频的固定间隔刷新，可以用ctx.request_repaint_after(Duration::from_millis(16))指定重绘间隔，不需要后台线程手动触发。

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