使用Bokeh组件（复选框、下拉框）时遇TypeError错误求助

一、先解决监听器参数报错的问题 #

你遇到的TypeError核心原因是：Bokeh中组件（比如下拉菜单Select）的on_change监听器函数，必须严格接受三个位置参数：

• attr：发生变化的组件属性名（比如下拉菜单的value属性）
• old：属性变化前的旧值
• new：属性变化后的新值

如果你的函数没有这三个参数，就会触发参数缺失的错误。举个正确的写法示例：

# 正确的监听器函数签名
def handle_column_change(attr, old, new):
    # new就是用户刚选中的新列名，后续写更新逻辑
    pass

# 给列选择下拉菜单绑定监听器，监听value属性变化
column_select.on_change('value', handle_column_change)

如果不需要用到attr和old，可以用下划线占位忽略，但参数位置必须保留：

def handle_column_change(_, __, new):
    # 只使用new参数处理逻辑
    pass

二、调用监听器后更新分类列表的方法 #

当用户切换选中的列时，你需要从DataFrame中提取该列的唯一分类值，然后更新分类下拉菜单的options属性，Bokeh Serve会自动同步到前端界面。

这里给你一个完整的可运行示例：

from bokeh.io import curdoc
from bokeh.models import Select
from bokeh.layouts import column
import pandas as pd

# 模拟你的含分类数据的DataFrame
df = pd.DataFrame({
    "产品类别": ["电子产品", "家电", "电子产品", "服饰", "家电"],
    "销售区域": ["华东", "华北", "华南", "华东", "华北"],
    "销售额": [12000, 8000, 15000, 6000, 9000]
})

# 初始化列选择下拉菜单
category_columns = ["产品类别", "销售区域"]
column_select = Select(title="选择分类列", options=category_columns, value=category_columns[0])

# 初始化分类选择下拉菜单（用第一列的唯一值）
initial_categories = df[column_select.value].unique().tolist()
category_select = Select(title="选择分类", options=initial_categories, value=initial_categories[0])

# 定义监听器：切换列时更新分类选项
def update_category_list(attr, old, new):
    # 提取选中列的唯一分类值（处理空值的话可以加.dropna()）
    updated_categories = df[new].dropna().unique().tolist()
    # 更新分类下拉菜单的选项
    category_select.options = updated_categories
    # 设置默认选中第一个分类
    category_select.value = updated_categories[0]

# 绑定监听器
column_select.on_change('value', update_category_list)

# 将组件添加到Bokeh文档
curdoc().add_root(column(column_select, category_select))

三、额外注意事项 #

1. 初始值要匹配：初始化分类下拉菜单时，要确保value在options列表里，否则会出现初始状态异常。
2. 自动同步前端：只要修改了组件的options或value属性，Bokeh Serve会自动刷新前端，不需要手动调用刷新方法。
3. 处理特殊值：如果你的DataFrame分类列有重复值、空值，记得用unique()和dropna()处理，避免下拉菜单出现无效选项。

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