Dash框架中app.callback无法更新dash_split_pane组件求助

我遇到了无法用app.callback更新dash_split_pane组件的问题，以下是相关代码片段，完整代码及测试用CSV文件可在对应仓库获取。

app.layout = dash_split_pane.DashSplitPane(
    children=[pane1, pane2],
    id="splitter",
    split="vertical",
    size=500
    )

@app.callback(Output('splitter', 'children'), 
              Input('upload-data', 'contents'),
              State('upload-data', 'filename'),
              State('table-container_3', 'data'),
              prevent_initial_call=True) #必须添加此参数，否则其余代码无法运行
def update_plot(HR_df, filename, GUI_df):
    if filename is not None:
        global pane1
        children = [pane1, [parse_contents_plot(HR_df, filename, GUI_df)]] #该函数在html.div内生成图表
        
        return children

问题分析与解决方案 #

核心问题点：

1. 全局变量误用：回调中使用global pane1会导致多用户环境下状态混乱，且Dash的回调依赖props的显式变化，全局变量修改不会触发正确的组件更新逻辑。
2. children结构错误：返回的第二个子元素是嵌套列表[parse_contents_plot(...)]，而dash_split_pane要求children是两个独立的组件，不是嵌套列表结构。

修改后的回调代码：

@app.callback(Output('splitter', 'children'), 
              Input('upload-data', 'contents'),
              State('upload-data', 'filename'),
              State('table-container_3', 'data'),
              prevent_initial_call=True)
def update_plot(HR_df, filename, GUI_df):
    if filename is not None:
        # 生成右侧面板的新内容（确保返回的是单个Dash组件，如html.Div）
        new_right_pane = parse_contents_plot(HR_df, filename, GUI_df)
        # 返回符合要求的两个组件列表
        return [pane1, new_right_pane]

额外排查步骤：

• 在回调中添加print(filename)等日志，确认上传文件时回调是否被触发；
• 单独测试parse_contents_plot的返回值，确保它生成的是有效的Dash组件（可直接渲染该组件验证）；
• 尝试更新dash_split_pane的size属性测试回调是否生效，排查组件本身是否能响应回调。

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