SpaCy加载en_core_web_md时报错：TypeError: issubclass() arg1必须是类

问题场景 #

之前用spacy.load("en_core_web_sm")正常运行，切换en_core_web_md模型后出现异常。测试SpaCy 3.6.1至3.2.0多个版本，成功安装3.2.0并下载en_core_web_md，但执行nlp = spacy.load("en_core_web_md")时触发TypeError: issubclass() arg 1 must be a class，且小、中模型均报此错误。

相关代码 #

!pip install spacy==3.2.0
!python -m spacy download en_core_web_md
import spacy
from pydantic import BaseModel
import spacy

核心报错 #

TypeError                                 Traceback (most recent call last)
<ipython-input-2-8bdf9ac04f54> in <module>
      1 # Initialize SpaCy model
----> 2 nlp = spacy.load("en_core_web_md")

...
TypeError: issubclass() arg 1 must be a class

解决方法 #

1. 修复Pydantic版本兼容性问题 #

SpaCy 3.2.0仅兼容Pydantic v1.x系列，若安装了Pydantic v2.x会导致类继承检查逻辑冲突，触发该错误。操作步骤：

• 卸载当前Pydantic：pip uninstall -y pydantic
• 安装兼容版本：pip install pydantic~=1.10.0
• 重新运行模型加载代码测试

2. 清理缓存并重新安装模型 #

模型下载不完整或缓存损坏也可能引发此类异常：

• 删除SpaCy模型缓存目录（通常路径为~/.cache/spacy，或虚拟环境下的lib/pythonX.X/site-packages/en_core_web_md）
• 重新下载模型：python -m spacy download en_core_web_md

3. 检查依赖包版本冲突 #

查看是否有其他依赖库版本异常，比如numpy、catalogue等。执行pip list列出所有包版本，确保没有与SpaCy 3.2.0不兼容的高/低版本依赖。

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