Bokeh带分类值水平条形图渲染为白盒、提示无法设置初始范围的问题求助

核心报错根因 #

控制台提示的[Bokeh] could not set initial ranges，本质是分类类型y轴的范围未被显式声明，导致Bokeh在嵌入模式下无法自动推导有效坐标轴范围。
你已经验证过Bokeh头部引入正常、基础折线图可渲染，说明页面加载链路没有问题，异常完全来自水平条形图的坐标轴配置缺失。

问题产生原因 #

你当前代码初始化绘图对象时，没有给figure传入分类y轴的范围参数：

• 基础折线图使用连续数值坐标轴，自动范围计算的容错性更高，不会触发这类范围推导失败的问题
• 嵌入场景（使用components()拆分JS脚本和DOM标签的服务端渲染流程）下，Bokeh不会像本地直接调用show()那样自动从图元数据反推分类轴的范围，必须显式声明，否则前端拿到序列化的绘图配置时，无法识别y轴应该对应哪些分类值，最终因为有效范围缺失渲染为白盒。

修复后完整代码 #

from bokeh.embed import components
from bokeh.plotting import figure

fruits = ['Apples', 'Pears', 'Nectarines', 'Plums', 'Grapes', 'Strawberries']
counts = [5, 3, 4, 2, 4, 6]

p = figure(
    plot_height=250, 
    title="Fruit counts",
    toolbar_location=None, 
    tools="",
    y_range=fruits  # 核心补全项：显式声明分类y轴的取值范围
)

# 可选优化：显式指定条形高度，避免默认值和分类轴刻度间距不适配
p.hbar(y=fruits, right=counts, height=0.7)

data, div = components(p)

额外校验建议 #

如果补全y_range后仍存在范围计算异常，可以在figure初始化参数中追加显式的x轴范围声明，避免数值轴自动计算出现偏差：

• 添加x_range=(0, max(counts) * 1.1)，给条形右端留出少量视觉边距，进一步降低范围推导失败的概率。

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