本文详解 pymilvus 中 `collection.delete()` 方法报错“failed to create expr plan”的根本原因——字符串类型主键未加单引号，提供安全、健壮的删除实现方案，并涵盖表达式语法规范、类型校验与最佳实践。
在 Milvus 向量数据库中，通过 pymilvus 删除实体时，表达式（expr）的语法必须严格符合 Milvus 查询语言（Boolean Expression）规范。你遇到的错误：
failed to create expr plan, expr = obj_id in [65ce930d39989b871863b5dd]
根本原因在于：obj_id 字段为字符串类型（如 MongoDB ObjectId 转换的 _id），但在删除表达式中直接拼接了未经引号包裹的值，导致 Milvus 将其解析为标识符或数字字面量，而非字符串字面量，从而无法构建合法的执行计划。
✅ 正确写法需为字符串值显式添加单引号（Milvus 表达式仅支持单引号表示字符串）：
def delete_entities(self, collection_name: str, entity_id: str) -> None:
# ✅ 正确：字符串 ID 必须用单引号包裹
expr = f"obj_id in ['{entity_id}']"
collection = Collection(collection_name)
# 可选：确保 collection 已加载（尤其在 compact 或 search 前）
if not collection.is_loaded():
collection.load()
result = collection.delete(expr)
print(f"Deleted {result.delete_count} entities")
⚠️ 注意事项与增强实践：
-
永远避免字符串拼接构造表达式（易受注入或格式错误影响）。推荐使用 f-string 并严格转义单引号（若 entity_id 本身含 ‘，需预处理）：
