Plotly直方图在Jupyter中无法输出的问题求助

问题背景 #

• 数据已确认有效：decrease_percentage列共299300条浮点型数据，PostgreSQL查询可获取有效结果
• 执行代码后无图表输出，重启/重载Jupyter无效，此前绘图功能正常，调试显示fig对象存在数据
• 涉及代码：

import plotly.express as px

fig = px.histogram(df.to_pandas(), x="decrease_percentage", log_y=True, nbins=20, text_auto=True,
                   width=1600, title="decrease_percentage")
fig.update_traces(xbins_size=1)
fig.show()

排查步骤与解决办法 #

1. 手动指定Plotly渲染器 #

Jupyter默认渲染器可能异常，尝试指定对应环境的渲染器：

# 针对Jupyter Notebook
fig.show(renderer="notebook")
# 针对JupyterLab
fig.show(renderer="jupyterlab")

若仍无效，初始化Plotly离线模式：

import plotly
plotly.offline.init_notebook_mode(connected=True)

2. 修正参数冲突与数据分布问题 #

• nbins=20和xbins_size=1可能冲突：若decrease_percentage数值范围远小于20，强制设置xbins_size=1会导致分箱异常，先移除fig.update_traces(xbins_size=1)再测试
• 关闭log_y=True验证：对数轴在分箱计数为0时会显示异常，先关闭该参数确认图表能否正常渲染，再调整分箱参数

3. 升级依赖确保版本兼容 #

版本不匹配可能导致渲染失败：

# 升级Plotly到最新稳定版
pip install --upgrade plotly
# 升级并启用Jupyter交互组件
pip install --upgrade ipywidgets
jupyter nbextension enable --py widgetsnbextension

4. 测试最小可复现案例 #

用简化数据验证渲染功能，排除原数据量过大或特殊值影响：

import pandas as pd
import plotly.express as px

test_df = pd.DataFrame({"decrease_percentage": [1.2, 3.4, 5.6, 2.3, 4.5, 6.7, 3.2, 5.1]})
fig = px.histogram(test_df, x="decrease_percentage", log_y=True, nbins=5)
fig.show()

若测试案例正常显示，说明原数据存在极端值，可先过滤再绘图：

# 过滤合理范围外的数值（示例范围：-100到100）
filtered_df = df.to_pandas().query("decrease_percentage >= -100 and decrease_percentage <= 100")
fig = px.histogram(filtered_df, x="decrease_percentage", log_y=True, nbins=20, text_auto=True, width=1600, title="decrease_percentage")
fig.show()

5. 检查Jupyter输出设置 #

确保单元格输出未被隐藏，或切换到JupyterLab环境测试（旧版Notebook对Plotly支持较差）

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