在 opensearch 中，要将字段（如 `platform`）以字符串数组形式正确存储和检索，需确保数据结构为 python 列表、索引映射支持多值字段，且查询方式兼容数组语义——而非依赖 query workbench 的默认单值渲染。
OpenSearch 原生支持多值字段（multi-value fields），但其行为高度依赖索引映射定义与客户端数据格式的协同。你当前遇到的问题——传入 ['PlayStation 4', 'Cassette Recorder'] 却只存下第一个元素——通常并非 OpenSearch 拒绝数组，而是由以下任一原因导致：
✅ 正确做法：三步验证与修复
1. 确保数据以标准 JSON 数组格式提交
你的 Python 字典必须明确传递 Python list（非逗号分隔字符串），且 requests.post(..., json=data) 会自动序列化为合法 JSON 数组：
data = {
'id': 693103,
'platform': ['PlayStation 4', 'Cassette Recorder'] # ✅ 正确：list of strings
}
push_to_opensearch(data)⚠️ 注意：若 platform 字段在原始数据中是字符串（如 'PlayStation 4, Cassette Recorder'），需在写入前手动拆分：raw_platform = "PlayStation 4, Cassette Recorder" platform_list = [s.strip() for s in raw_platform.split(',')] # → ['PlayStation 4', 'Cassette Recorder'] data['platform'] = platform_list
2. 映射必须允许多值（默认即支持，但需确认）
你当前的映射：
"platform": { "type": "keyword", "ignore_above": 200 }✅ 完全正确——keyword 类型默认支持多值数组，无需额外配置 "index": true 或 "multi_field"。OpenSearch 会将数组每个元素独立索引（可用于 terms 查询、聚合等）。
? 验证映射是否生效（执行一次）：
curl -X GET "https://localhost:9200/new_index_name/_mapping?pretty" \ -u 'admin:BSOIT2020' --insecure确认响应中 platform 的 type 确为 "keyword"。
3. 查询时使用支持数组语义的 API（避免 Query Workbench 误导）
Query Workbench（尤其旧版）可能仅显示数组首项用于预览，不代表实际存储失败。务必用 Dev Tools 或 curl 验证真实数据：
// 使用 _search 查看完整文档（推荐）
GET /new_index_name/_search
{
"query": { "match": { "id": 693103 } },
"_source": ["id", "platform"]
}响应中你会看到：
"hits": [{
"_source": {
"id": 693103,
"platform": ["PlayStation 4", "Cassette Recorder"] // ✅ 完整数组返回
}
}]✅ 补充：验证数组是否真正可查（关键测试）
// 查询包含任一平台的文档
GET /new_index_name/_search
{
"query": {
"terms": { "platform": ["PlayStation 4"] }
}
}若返回匹配结果，证明数组已成功索引并可用。
? 总结与最佳实践
- ✅ 数据层：始终传入 list[str]，而非拼接字符串；
- ✅ 映射层：keyword/text 类型均原生支持多值，无需修改；
- ✅ 查询层：避免 GUI 工具的渲染限制，优先使用 Dev Tools 或 _search API 验证；
- ⚠️ 警惕：若索引已存在且映射错误，不能直接修改已有字段类型——需重建索引（reindex）并设置正确 mapping；
- ? 进阶：如需全文搜索数组内容，可为 platform 添加 text 子字段：
"platform": { "type": "keyword", "fields": { "text": { "type": "text" } } }
遵循以上步骤，即可稳定、可靠地在 OpenSearch 中存储、索引和检索字符串数组。
