Plotly多导出图表合并为子图解决方案：加载JSON文件后add_trace报错处理

错误原因分析 #

你遇到的问题核心很清晰：make_subplots()的add_trace()方法不接受完整的Figure对象，它仅支持单个trace（比如Scatter、Bar这类实例）或trace列表作为参数。而你直接传入了read_json()返回的整个Figure，这就触发了ValueError。

解决方案：提取trace与布局元素并整合到子图 #

每个保存为JSON的Plotly Figure，其核心可视化数据（散点、线条等）都存储在fig.data属性中；你添加的vline、vrect这类辅助布局元素则在fig.layout.shapes里。我们需要分别提取这两部分内容，再添加到子图的对应位置。

下面是完整的可运行代码：

import plotly.graph_objects as go
from plotly.subplots import make_subplots
import plotly.io as pio

# 创建2×2的子图布局
fig_total = make_subplots(rows=2, cols=2, start_cell='top-left')

# 遍历4个目标图表文件（请根据实际文件名调整路径规则）
for i in range(4):
    # 读取JSON文件，得到单个Figure对象
    fig = pio.read_json(f'plotly/filename_{i}.json')
    
    # 1. 将当前Figure的所有trace添加到子图对应行列
    for trace in fig.data:
        fig_total.add_trace(
            trace,
            row=int(i/2)+1,
            col=(i%2)+1
        )
    
    # 2. 迁移vline、vrect这类布局形状到对应子图区域
    for shape in fig.layout.shapes:
        # 必须指定形状所属的子图行列，否则会默认显示在整个画布
        shape.update(row=int(i/2)+1, col=(i%2)+1)
        fig_total.layout.shapes.append(shape)

# 可选：调整子图整体布局（比如尺寸、标题）
fig_total.update_layout(height=800, width=1200, title_text="合并后的2×2子图")

# 保存或展示合并后的图表
fig_total.write_html('plotly/combined_subplots.html')
fig_total.show()

关键细节说明 #

• trace提取与添加：每个Figure的data是包含所有可视化trace的列表，需要逐个遍历添加到子图的对应位置，确保每个trace归属正确的子图单元格。
• 布局形状迁移：vline和vrect属于布局的shapes集合，添加到子图时必须通过row和col指定所属子图，否则会错误地显示在整个画布而非目标子图区域。
• 文件名适配：代码中假设你的4个JSON文件命名为filename_0.json到filename_3.json，请根据实际的文件命名规则修改循环内的路径。

额外优化提示 #

如果你的原始图表还有其他布局配置（比如坐标轴标签、图例），可以按需补充处理：

• 坐标轴标签：通过fig_total.update_xaxes()和fig_total.update_yaxes()为每个子图单独设置轴标签。
• 图例管理：创建子图时可设置shared_yaxes/shared_xaxes参数，或通过fig_total.update_layout(legend=...)统一调整图例位置与样式。

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