Dash回调返回Plotly Figure报不可JSON序列化错误求助

你遇到的两类报错本质都是版本兼容导致的序列化识别问题，和回调业务逻辑无关：

• 直接返回Figure给graph.figure触发JSON序列化错误：正常情况下Dash 2.0及以上版本内置了Plotly Figure的序列化逻辑，可以直接接收plotly.express/plotly.graph_objects生成的原生Figure对象。触发这个错误要么是Dash/Plotly版本过低，要么是环境中存在多版本冲突，导致序列化器无法识别传入的Figure是合法可序列化对象，把它当成普通自定义类处理。
• 返回dcc.Graph组件给容器children触发AttributeError: 'list' object has no attribute 'component_property'：这是老版本Dash模式匹配回调的已知bug，当使用字典形式的模式匹配ID（就是你写的Input({"type": "key", "index": ALL}, "value")）时，回调返回单个组件而非组件列表的话，校验逻辑会错误把组件对象当成输出列表遍历，尝试读取元素属性触发报错。后续把组件包成列表返回仍触发序列化错误，本质还是之前的Figure无法识别的问题，连带整个Graph组件都不能正常序列化。
• 你提到其他动态添加过滤器的回调返回组件正常，是因为那些组件的属性都是基础类型（字符串、数字、普通字典），不存在需要特殊序列化的Plotly对象，所以不会触发这个问题，dcc.Graph本身不需要特殊处理。

按优先级从高到低尝试：

• 优先方案：升级依赖到兼容版本
  这是解决问题最彻底的方法，在终端执行命令升级核心包：

  pip install --upgrade dash plotly
  

  升级完成后直接使用最开始的回调逻辑即可，不需要绕路返回整个Graph组件，直接返回Figure就能正常渲染：

  @app.callback(
      Output("graph", "figure"),
      Input({"type": "key", "index": ALL}, "value"),
  )
  def apply_filters(val):
      dat = px.data.iris()
      figure = px.scatter(dat, x='sepal_width', y='sepal_length', color='species', title='A Plotly Express Figure')
      return figure
  

• 兼容方案：手动转换Figure为可序列化格式
  如果受项目限制不能升级版本，手动调用Figure的内置方法把它转成普通字典结构再返回，绕开自动序列化的识别问题：

  @app.callback(
      Output("graph", "figure"),
      Input({"type": "key", "index": ALL}, "value"),
  )
  def apply_filters(val):
      dat = px.data.iris()
      figure = px.scatter(dat, x='sepal_width', y='sepal_length', color='species', title='A Plotly Express Figure')
      return figure.to_plotly_json()
  

• 备选方案：动态替换整个Graph组件（不推荐）
  如果你确实需要整体替换容器内的图表组件，注意老版本模式匹配回调返回children时需要返回组件列表，同时传入的figure也要提前转成可序列化格式：

  @app.callback(
      Output("graph-container", "children"),
      Input({"type": "key", "index": ALL}, "value"),
  )
  def apply_filters(val):
      dat = px.data.iris()
      figure = px.scatter(dat, x='sepal_width', y='sepal_length', color='species', title='A Plotly Express Figure')
      graph = dcc.Graph(
          id="graph",
          figure = figure.to_plotly_json()
      )
      return [graph]
  

注意：直接更新dcc.Graph的figure属性性能远好于替换整个组件，后者每次回调都会销毁重建整个图表，前者只会触发图表的增量重绘，没有特殊需求不要用替换组件的写法。

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