LlamaIndex删除LanceDB文档报No field named item1

调用LlamaIndex的LanceDB适配器删除文档，报 No field named item1，但表里的 doc_id 列确实存在。这里可能是文档ID被解析成了列名：旧适配器生成的条件使用双引号包住ID，LanceDB的新版本按SQL标识符解释这段内容。

已核对的组合是 llama-index-vector-stores-lancedb 0.6.0与LanceDB 0.38.0及以后相关版本。0.38.0加入了双引号标识符的过滤处理；0.6.0的删除路径仍生成双引号ID条件。报错说明删除操作没有正常完成，不能先按“已删除但缓存没有刷新”处理。

看清异常中的名字指什么

下面两段条件含义不同，只用于说明解析差异，不执行删除：

doc_id = "item1"
doc_id = 'item1'

第一段的 item1 会被当作标识符；表里没有这个字段，就报 No field named item1。第二段把它作为字符串值，才表达文档ID等于item1。

先保留完整堆栈，确认错误发生在 delete()、delete_nodes() 还是查询条件。0.6.0的 get_nodes() 也有相关条件构造，不能只修正一个删除入口就认定所有路径都恢复。若报错指向真正不存在的列，仍需检查表结构，不把所有 No field named 都归到引号问题。

检查工作进程实际安装的两个包

下面只读取包版本，不打开数据库，也不发送模型请求：

from importlib.metadata import version

for package in ("llama-index-vector-stores-lancedb", "lancedb"):
    print(package, version(package))

适配器0.6.0声明的LanceDB依赖下限是0.21.1，没有相应的版本上限，因此依赖解析可能得到带新语义的组合。锁文件没有改变适配器版本，也不代表底层LanceDB没有升级。

截至2026年10月11日核对的发布记录，适配器正式版仍是0.6.0，修正这条路径的改动尚未合并发布。不能把提出过的0.6.1版本号当作已经可安装的修复版。升级或版本固定都应以实际发布包、依赖兼容性和数据库文件兼容性为准，不建议直接降级后打开唯一的生产数据副本。

临时调整要区分字段名和字符串值

若在隔离副本里确认条件构造有误，处理ID字面量时应按SQL字符串规则转义单引号，例如 item'1 对应 'item''1'。不能对整段过滤表达式做双引号到单引号的全局替换，里面可能本来就有需要引用的字段名。

临时封装还应处理空ID列表，避免生成无效条件或意外扩大删除范围。底层表达式API也是一种选择，但要核对版本支持；适配器的依赖下限0.21.1不能保证具备较后版本的所有表达式删除接口。远程表与本地表的能力也不能默认相同。

先备份并在副本中用只读计数或选取确认匹配记录，再测试删除。范围要由业务授权的精确ID决定，不能用模糊匹配代替。文档ID、节点ID和真实列名需要分别核对，避免字符串条件正确却删除了错误层次的数据。

验证应覆盖普通ID、含单引号的ID、空列表及不存在的ID，并检查无关记录保留。随后关闭、重新打开同一数据存储，确认记录状态，再从应用原有检索入口回查。与embedding维度错误不同，这条路径不需要通过换模型来解决；若异常出现在包装检索器的属性读取，可以对照检索器对象类型检查。