nbconvert转换HTML/PDF失败：'application/vnd.jupyter.widget-state+json'错误求助

• 清理Notebook的交互式组件状态
  该错误大多因Notebook中包含未正确处理的Jupyter Widgets交互控件导致。可按以下方式处理：

  1. 打开目标Notebook，点击菜单栏Kernel -> Restart & Clear Output，清空所有单元格输出后再尝试导出；
  2. 若不需要保留交互状态，可直接编辑.ipynb文件，找到metadata下的widgets字段，删除整个节点后保存，再执行导出命令。

• 使用Widget专用转换参数
  若需保留交互组件，先确保安装并启用ipywidgets扩展，再带参数执行导出：

  pip install ipywidgets
  jupyter nbextension enable --py widgetsnbextension
  jupyter nbconvert --to html --execute notebook.ipynb --allow-errors
  

  --execute会确保所有Widget被正确渲染，--allow-errors避免因单元格报错中断转换。

• 降级nbconvert版本
  部分新版nbconvert对Widget状态处理存在兼容性问题，可尝试降级至稳定版本：

  pip install nbconvert==6.4.0
  

• 更新相关依赖包
  确保ipywidgets、nbconvert与pandoc的版本匹配，执行以下命令统一更新：

  pip install --upgrade ipywidgets nbconvert pandoc
  

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