在 PyMilvus 中，若需查询 JSON 字段中某数组是否包含指定元素（如 ["A", "B", "C"] 中是否含 "A"），应使用 json_contains_any 而非 json_contains，后者仅支持完整值匹配，不适用于数组内元素检索。
在 pymilvus 中，若需查询 json 字段中某数组是否包含指定元素（如 `["a", "b", "c"]` 中是否含 `"a"`），应使用 `json_contains_any` 而非 `json_contains`，后者仅支持完整值匹配，不适用于数组内元素检索。
当使用 Milvus 的 JSON 字段存储嵌套结构（例如 {"field_a": "x", "list_field": ["A", "B", "C"]}）时，对数组字段进行“成员存在性”判断是常见需求。但需特别注意：json_contains 并不等价于 SQL 中的 IN 或 Python 的 in 操作——它将整个 JSON 值（如 ["A","B","C"]）视为一个原子对象，仅当查询值完全等于该 JSON 值本身时才返回 true（例如 json_contains(metadata["list_field"], '["A","B","C"]')）。因此，直接用 json_contains(metadata["list_field"], "A") 会失败或返回空结果。
✅ 正确做法是使用 json_contains_any：
from pymilvus import Collection
# 假设 collection 已创建并加载
results = collection.query(
expr='json_contains_any(metadata["list_field"], ["A"])',
output_fields=["metadata", "vector"]
)
⚠️ 注意事项：
- json_contains_any 的第二个参数必须是 JSON 数组字面量（即带方括号的字符串，如 ["A"]、["A", "B"]），而非单个字符串 "A"；
- 若需匹配多个候选值（如查找 list_field 中包含 "A" 或 "C" 的记录），可传入 ["A", "C"]；
- 确保 metadata 字段在建表时已正确定义为 DataType.JSON 类型，且集合已加载（collection.load()）；
- 表达式中的 JSON 路径（如 metadata["list_field"]）区分大小写，且不支持嵌套点号语法（如 metadata.list_field 不合法）。
? 小结：
json_contains → 判断 JSON 值是否完全等于给定值（适合匹配整个对象或字符串）；
json_contains_any → 判断 JSON 数组是否包含任意一个指定元素（适合本场景的列表成员检索）。
这是 Milvus JSON 查询的核心语义差异，正确选用可避免无效查询与调试耗时。
