在JupyterHub代理的Jupyter Notebook中开发Bokeh应用遇空输出问题

嘿，我之前在JupyterHub环境下开发Bokeh应用时也碰到过类似的情况——要兼顾Notebook里的交互式调试，还要保证代码能直接导出部署到Bokeh Server，结果Notebook里代码没报错却输出空。给你梳理几个关键的排查点和解决方案：

1. 先搞定Notebook里的兼容输出初始化 #

你不想用Notebook专属组件是对的，但得先让Bokeh在Notebook里能正常渲染，同时不影响后续部署。可以加个判断，只在Notebook环境下启用Notebook输出：

from bokeh.plotting import figure, show, output_notebook
import sys

# 只在Notebook内核环境下初始化Notebook输出
if 'ipykernel' in sys.modules:
    output_notebook()

这样导出到Python文件后，这段代码在Bokeh Server环境下会自动跳过，不会有冲突。

2. 用Bokeh Server兼容的回调结构（核心！） #

要回调Notebook内核的Python代码，同时代码能直接部署到Server，绝对不能用push_notebook()这类Notebook专属API。正确的做法是采用Bokeh Server的curdoc()模式，在Notebook里通过show()启动一个临时的Bokeh Server实例：

from bokeh.plotting import figure, curdoc
from bokeh.models import Button
from bokeh.io import show
from bokeh.layouts import column

# 创建你的可视化组件
p = figure(width=300, height=300)
circle_renderer = p.circle([1,2,3], [4,5,6])

# 写通用的Python回调——这段代码在Notebook和Bokeh Server里都能跑
def update_circles():
    # 直接操作数据源，回调Notebook内核的Python逻辑
    current_y = circle_renderer.data_source.data['y']
    circle_renderer.data_source.data['y'] = [y + 1 for y in current_y]

# 绑定回调到按钮
update_btn = Button(label="点击更新数据")
update_btn.on_click(update_circles)

# 构建布局
layout = column(update_btn, p)

# 在Notebook里启动临时Bokeh Server渲染
# 这里的notebook_url要换成你JupyterHub的实际地址，比如你的Hub域名或内部IP+端口
show(layout, notebook_url="http://your-jupyterhub-url:8888")

这种方式下，Notebook里会嵌入一个Bokeh Server的iframe，回调直接触发Python代码，而且代码导出后，只需要跑bokeh serve --show your_script.py就能部署，完全不用改代码。

3. 排查输出为空的常见坑 #

如果还是输出空，检查这几点：

• 确认你调用了show()，而且参数是你的布局对象（别漏传或者传错了）
• 打开浏览器控制台看看有没有JS错误：右键页面→检查→控制台，比如Bokeh的CDN资源加载失败（JupyterHub的代理可能需要允许外部CDN，或者你可以用本地的Bokeh资源）
• 如果你手动加了script标签，一定要保证标签里的Bokeh版本和你Python环境里的版本一致，版本不匹配直接会导致渲染失败：

  import bokeh
  print(bokeh.__version__)
  

  然后对应修改script标签里的CDN链接，比如版本是2.4.3的话，就用：

  <script src="https://cdn.bokeh.org/bokeh/release/bokeh-2.4.3.min.js"></script>
  <link rel="stylesheet" href="https://cdn.bokeh.org/bokeh/release/bokeh-2.4.3.min.css">
  

4. 彻底避开Notebook专属组件 #

确保代码里没有用ipywidgets和Bokeh的混合组件，也不要用bokeh.io.push_notebook()这类只在Notebook里生效的API——这些代码不仅在Server部署时会报错，还可能导致Notebook里的渲染异常。

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