Mac Monterey下Jupyter Notebook报500内部服务器错误（已更新nbconvert）

1. 锁定Jinja2兼容版本 #

contextfilter在Jinja2 3.1.0及以上版本中被移除，替换为pass_context装饰器。旧版nbconvert依赖该旧API，即使升级nbconvert也可能因依赖约束未生效导致问题。直接安装兼容版本：

pip install jinja2==3.0.3

若使用虚拟环境，需先激活环境再执行命令。

2. 强制重装nbconvert并清理缓存 #

升级后残留的缓存或旧文件可能引发异常，先卸载再重装并清理pip缓存：

pip uninstall -y nbconvert
pip cache purge
pip install nbconvert --no-cache-dir

完成后重启Jupyter Notebook。

3. 统一升级Jupyter核心组件版本 #

Jupyter各组件版本需匹配，先查看当前版本：

jupyter --version

若存在版本偏差，统一升级核心组件：

pip install --upgrade jupyter-core jupyter-client nbconvert jinja2

4. 手动修复nbconvert源码（临时应急） #

若上述方法无效，可临时修改nbconvert中引用contextfilter的代码：

1. 定位nbconvert安装路径（如虚拟环境下的lib/python3.8/site-packages/nbconvert）
2. 搜索所有包含from jinja2 import contextfilter的文件，替换为：

   from jinja2 import pass_context
   

3. 将原使用@contextfilter装饰器的函数，替换为@pass_context
   注意：此方法为临时方案，后续升级nbconvert会覆盖修改，优先使用版本控制方法。

5. 切换Python版本（可选） #

Python 3.8与最新Jinja2、nbconvert可能存在兼容问题，若项目允许，可切换至Python 3.9/3.10后重建环境：

# 以pyenv版本管理为例
pyenv install 3.9.16
pyenv local 3.9.16
python -m venv new_env
source new_env/bin/activate
pip install jupyter notebook

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