保存Bokeh图表后调用show报错，装饰器顺序影响问题排查

核心问题：Bokeh模型的Document唯一性约束 #

Bokeh的所有可视化模型（比如Figure）都严格绑定到唯一的Document实例，任何尝试将同一个模型添加到多个Document的操作都会触发Models must be owned by only a single document错误。

装饰器顺序为什么会导致差异 #

装饰器的执行逻辑是从下到上绑定，从外到内执行：

• 当你写@showable在上、@savable在下时，实际等价于：

  your_func = showable(savable(your_func))
  

  调用函数时的执行流程是：

  1. 先执行savable的包装逻辑：生成Figure，调用Bokeh的save()——这一步会自动创建一个临时Document并将Figure加入其中完成保存。
  2. 接着执行showable的包装逻辑：拿到已经属于临时Document的Figure，调用show()——show()会尝试创建另一个新Document来渲染图表，此时同一个Figure被两个Document争抢，直接触发错误。

• 当你把顺序改成@savable在上、@showable在下时，等价于：

  your_func = savable(showable(your_func))
  

  执行流程变为：

  1. 先执行showable的包装逻辑：生成Figure，调用show()——创建一个Document并将Figure加入其中展示。
  2. 接着执行savable的包装逻辑：拿到已经属于展示用Document的Figure，调用save()——save()会直接复用已有的Document完成保存，不会创建新的，因此不会触发冲突。

实现「保存后再展示」的正确姿势 #

如果需要严格遵循「先保存、再展示」的顺序，需要修改装饰器逻辑，确保保存操作不会让Figure永久绑定到临时Document，或者让两个装饰器共用同一个Document：

方案1：修改savable装饰器，保存后解除模型绑定

from bokeh.io import save
from bokeh.document import Document

def savable(func):
    def wrapper():
        fig = func()
        # 创建临时Document用于保存
        temp_doc = Document()
        temp_doc.add_root(fig)
        # 执行保存
        save(temp_doc, "your_figure.html")
        # 从临时Document移除Figure，解除绑定
        temp_doc.remove_root(fig)
        return fig
    return wrapper

之后用@showable在上、@savable在下的顺序，就能实现先保存、再展示，且不会触发错误——因为保存后Figure已经和临时Document解绑，show()可以正常将它加入新的Document。

方案2：让两个装饰器共用同一个Document

from bokeh.io import save, show, curdoc

def savable(func):
    def wrapper():
        fig = func()
        doc = curdoc()
        if fig not in doc.roots:
            doc.add_root(fig)
        save(doc, "your_figure.html")
        return fig
    return wrapper

def showable(func):
    def wrapper():
        fig = func()
        doc = curdoc()
        if fig not in doc.roots:
            doc.add_root(fig)
        show(doc)
        return fig
    return wrapper

这种方式下，不管装饰器顺序如何，save()和show()都会复用同一个全局Document，既不会有冲突，也能通过调整装饰器顺序控制执行流程（@showable在上就是先展示后保存，@savable在上就是先保存后展示）。

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