Milvus 向量数据库中删除实体时的表达式语法错误修复指南

在 milvus 中使用 `Collection.delete()` 删除实体时，若主键（如 `obj_id`）为字符串类型，过滤表达式必须将值用单引号包裹；否则会因表达式解析失败抛出 `failed to create expr plan` 异常。

在 Milvus 中执行条件删除操作时，delete() 方法依赖 sql-like 表达式（即 expr 参数）进行行级筛选。该表达式需严格符合 Milvus 的表达式语法规则：所有字符串类型的字段值必须用单引号（’）包裹，而数字类型可省略。从报错信息 expr = obj_id in [65ce930d39989b871863b5dd] 可明显看出：65ce930d39989b871863b5dd 是 MongoDB ObjectId 转换来的十六进制字符串，但表达式中未加引号，导致 Milvus 将其误判为标识符或数字字面量，最终解析失败。

✅ 正确写法（适配字符串主键）：

def delete_entities(self, collection_name, entity_id):     # ✅ 确保 entity_id 被单引号包裹，且整体为合法表达式     expr = f"obj_id in ['{entity_id}']"     collection = Collection(collection_name)     collection.delete(expr)

⚠️ 注意事项：

• 类型一致性：务必确认 obj_id 字段在 Milvus Schema 中定义为 DataType.VARCHAR（而非 INT64），否则即使加了引号也会因类型不匹配报错；
• SQL 注入风险：若 entity_id 来自不可信输入（如用户请求、外部 API），应避免直接拼接字符串。推荐改用参数化方式（当前 pymilvus 版本暂不支持 delete() 的参数化查询），故需手动校验/转义——例如限制 entity_id 仅含十六进制字符与固定长度（24 位）；
• 批量删除：如需删除多个 ID，可传入列表：expr = f”obj_id in [‘id1’, ‘id2’, ‘id3’]”；
• 空值与 None 处理：调用前建议增加校验，防止 entity_id 为 None 或空字符串导致无效表达式；
• 事务性保障：Milvus 的 delete 是异步落盘操作，删除后需配合 flush() 或等待 search 返回空结果来验证生效（尤其在测试环境）。

? 总结：Milvus 表达式是强类型上下文敏感的，看似微小的引号缺失会直接触发底层 PlanBuilder 解析异常。开发中应始终依据字段实际数据类型构造表达式，并通过 Collection.schema 检查字段定义，而非仅凭业务逻辑假设。