500 internal server error 根本原因在于后端渲染 notebook 页面时卡死，常见于 traitlets/typing-extensions 版本冲突、nbconvert 缺失或版本不匹配、tornado 版本过高，需通过终端日志定位最后一行报错并针对性修复。
500 Internal Server Error 在 Jupyter Notebook 里不是服务器崩了，而是后端在渲染 notebook 页面时卡死——通常是某个依赖包版本不兼容、缺失，或者内核启动失败。直接重装 jupyter 很大概率无效，得看日志、盯具体报错点。
看终端日志里的真实错误（不是浏览器弹窗）
浏览器只显示“500”，真正线索全在你启动 jupyter notebook 的终端窗口里。如果没开终端直接双击图标启动，就根本看不到关键信息。
- 务必从命令行启动：
jupyter notebook --no-browser，然后手动访问http://localhost:8888 - 打开一个 .ipynb 文件，立刻切回终端，找第一行红色 traceback（通常以
Traceback (most recent call last):开头） - 重点关注最后一行：比如
ImportError: cannot import name 'Self' from 'typing_extensions'或TemplateAssertionError: no filter named 'urlencode'—— 这才是根因
traitlets / typing-extensions 版本冲突（Python 3.12+ 常见）
Python 3.12 引入了内置 Self 类型，但旧版 typing_extensions 和 traitlets 还试图自己导出它，导致导入失败，进而让整个 notebook 渲染流程中断。
- 先检查版本：
pip show traitlets typing-extensions - 常见修复组合：
pip install traitlets==5.9.0 typing-extensions==4.9.0 - 不要只升级其中一个——必须匹配。例如
traitlets>=6.0要求typing-extensions>=4.8.0，但某些notebook版本反而和traitlets==5.9.0更稳
nbconvert 缺失或版本错配（最常被忽略的依赖）
notebook 包本身不带 nbconvert，但页面渲染 .ipynb 文件时会调用它做模板处理。很多 conda/pip 环境里它压根没装，或者装了但版本太老（如 nbconvert）。
- 验证是否缺失：
jupyter --version输出里没有nbconvert行，就是缺 - 装指定兼容版本：
pip install nbconvert==7.16.3（当前与notebook==7.2.0稳定共存） - 避免用
conda install nbconvert混装——conda-forge 和 defaults 频道的构建差异常引发隐性冲突
tornado 版本过高（尤其用了 jupyter_contrib_nbextensions 后）
tornado>=6.0 移除了 tornado.web.asynchronous 装饰器，但老版扩展（如 jupyter_contrib_nbextensions）或某些自定义 handler 还在用，一加载就炸，连带 notebook 页面 500。
- 查当前版本：
python -c "import tornado; print(tornado.version)" - 降级到安全版本：
pip install tornado==5.1.1（注意：不是5.1，必须带补丁号） - 如果你不需要 nbextensions，更推荐直接卸载：
pip uninstall jupyter_contrib_nbextensions，比降级 tornado 更干净
nbconvert，有人卡在 traitlets，有人被 tornado 绑架，还有人其实是内核路径配置错了却以为是前端问题。别跳过终端日志，也别无脑重装整个 jupyter。盯住最后一行报错，它已经把答案写好了。
