调用Spacy add_alias触发TypeError：需传入整数的问题排查

核心错误原因 #

你的代码存在两个关键问题：

• 调用kb.add_alias前未执行实体添加操作（仅注释标注但代码未实现）
• 传给entities参数的qid是整数类型，但SpaCy 3.x的KnowledgeBase要求实体ID必须为字符串类型

从堆栈追踪的代码entity_hash = self.vocab.strings[entity]可以明确：vocab.strings是字符串到哈希值的映射表，用整数查询会直接触发TypeError，因为它仅接受字符串作为键。

另外你提到的srsly版本问题和当前错误无关：SpaCy 3.4.4依赖srsly 2.x系列，降级到1.0.1必然引发兼容性问题（比如read_yaml属性缺失），完全不需要调整srsly版本。

修复后的完整代码 #

from spacy.kb import KnowledgeBase
import spacy 

nlp = spacy.blank("en")
kb = KnowledgeBase(vocab=nlp.vocab, entity_vector_length=96)
name = "test"
qid = "1"  # 将实体ID改为字符串类型
# 先注册实体（必须前置步骤，否则add_alias会报错实体不存在）
kb.add_entity(entity=qid, entity_vector=[0.]*96, freq=1.0)
# 传入字符串类型的实体ID调用add_alias
kb.add_alias(alias=name.lower(), entities=[qid], probabilities=[1])

关键注意事项 #

• kb.add_entity是强制前置操作：必须先把实体注册到知识库中，才能为其添加别名
• 实体ID必须用字符串：这是SpaCy 3.x版本KnowledgeBase的内部机制要求，通过字符串映射哈希值管理实体
• 保留原版本依赖：spacy 3.4.4 + srsly 2.4.5是兼容组合，无需修改依赖版本

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