Jupyter Notebook打开报500 Internal Server Error 求助（mistune模块异常）

核心原因 #

报错AttributeError: module 'mistune' has no attribute 'BlockGrammar'的本质是版本不兼容：

• 新版mistune（v3.0及以上）重构了核心代码，移除了旧版中的BlockGrammar类；
• 你的Jupyter Notebook版本偏旧，仍依赖mistune v2.x的API，两者版本不匹配导致服务启动失败；
• 问题突然出现的原因，大概率是你更新Jupyter或其他操作时，间接触发了mistune的自动升级。

解决步骤 #

1. 降级mistune到兼容版本 #

在Anaconda命令行执行以下命令，将mistune降级到v2.x的稳定版本：

conda install mistune=2.0.4

如果你的环境使用pip管理包，可执行：

pip install mistune==2.0.4

2. 验证修复结果 #

完成降级后，重新启动Jupyter Notebook，尝试打开Notebook文件，确认500错误是否消除。

3. 锁定版本防止再次升级 #

为避免后续操作自动升级mistune导致问题复发，可锁定版本：

• Conda环境：

conda config --add pinned_packages mistune=2.0.4

• Pip环境：
  在项目的requirements.txt中添加一行：

mistune==2.0.4

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