在Dash应用中实现Plotly FigureWidget的原位更新

问题根源 #

Dash默认回调更新图表时，会直接替换整个figure对象，导致缩放、trace可见性等交互状态被重置；而Jupyter的FigureWidget采用增量更新，仅修改数据部分，不会影响交互状态。

实现原位更新的两种方法 #

1. 使用Patch对象（推荐，Dash 2.9.0+） #

官方提供的Patch支持增量修改图表，无需重建整个figure：

• 导入Patch：from dash import Patch
• 回调中仅更新数据字段：

@app.callback(
    Output('graph', 'figure'),
    Input('load-more-btn', 'n_clicks'),
    State('graph', 'figure'),
    prevent_initial_call=False
)
def update_data(n_clicks, current_figure):
    if n_clicks is None:
        return initial_figure
    
    # 获取新数据
    new_x, new_y = get_more_data()
    
    # 创建Patch实例，仅追加数据到第一个trace
    patch = Patch()
    patch['data'][0]['x'] += new_x
    patch['data'][0]['y'] += new_y
    
    return patch

这种方式只会修改指定的数据部分，所有交互状态都会保留。

2. 复用当前figure状态（兼容旧版Dash） #

在回调中接收当前figure，仅修改数据后返回，保留原有布局和交互属性：

@app.callback(
    Output('graph', 'figure'),
    Input('load-more-btn', 'n_clicks'),
    State('graph', 'figure'),
    prevent_initial_call=False
)
def update_data(n_clicks, current_figure):
    if n_clicks is None:
        return initial_figure
    
    new_x, new_y = get_more_data()
    # 仅更新数据，保留原有布局与交互状态
    current_figure['data'][0]['x'] += new_x
    current_figure['data'][0]['y'] += new_y
    
    return current_figure

注意：这种方式效率低于Patch，需确保不修改交互相关的字段。

Jupyter服务器依赖确认 #

完全不需要依赖Jupyter服务器。Dash是独立的Web框架，运行时会启动自身的服务器（默认Flask），与Jupyter内核无绑定。之前在Jupyter中出现同步重置的问题，是因为FigureWidget和Dash应用共享了同一图表对象的状态，并非依赖Jupyter服务器导致。关闭Jupyter后，只要Dash进程未终止，应用可正常运行。

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