#2988·typesense

在集合加载(服务器重启)过程中,如果远程模型验证失败,则自动嵌入字段将被从集合的模式中静默且永久删除

作者: fagner-alves创建于 2026年7月17日更新于 2026年9月8日
标签bug

问题描述

当一个集合中有一个具有 embed 的字段,指向一个远程/自定义 OpenAI 兼容的嵌入模型(例如自主托管的 vLLM 实例),并且 Typesense 服务器重启后,CollectionManager::load() 会重新验证磁盘上找到的每个集合的远程模型。如果出于任何原因(远程端点暂时不可用,超时或远程服务拒绝了明确的 dimensions 参数),此验证调用失败,Typesense 将不会重试也不会失败,而是仅会记录一个 ERROR 行,并在重构集合的内存字段列表时默默地忽略该字段。该字段将不再存在:它不会出现在 GET /collections/:name 中,向量搜索对它不起作用,新索引的文档将不具有嵌入 — 而其他所有字段和现有文档都会正常加载。不存在重试,无法通过 API 观察此失败,也无法通过配置标志来更改此行为。

内容来源: typesense/typesense