opensearch 原生不支持 version_type=external 用于 _update api，但可通过 painless 脚本在更新时校验文档时间戳，仅当新时间戳更新时才执行写入，从而模拟外部版本语义。
在 OpenSearch 中，_update 操作默认仅支持基于内部序列号（if_seq_no / if_primary_term）的乐观并发控制，不支持 version_type=external 参数——该限制同样适用于 Elasticsearch，并且短期内官方无计划引入该能力。但你的核心诉求——“仅当新文档的 updateTimestamp（EPOCH 毫秒）严格大于现有文档对应字段时才更新”——完全可通过 Painless 脚本更新（Scripted Update） 高效、安全地实现。
✅ 推荐方案：使用 Painless 脚本进行条件更新
以下是一个生产就绪的脚本示例，它接收 updateTimestamp 和其他待更新字段作为参数，仅在时间戳更新时覆盖源文档字段：
POST /test_index/_update/123
{
"script": {
"lang": "painless",
"source": """
// 检查新时间戳是否更新（严格大于）
if (params.updateTimestamp > ctx._source.updateTimestamp) {
// 将所有传入参数（除 updateTimestamp 外）逐个写入 _source
for (entry in params.entrySet()) {
if (!entry.getKey().equals('updateTimestamp')) {
ctx._source[entry.getKey()] = entry.getValue();
}
}
// 强制更新时间戳本身（可选，确保一致性）
ctx._source.updateTimestamp = params.updateTimestamp;
} else {
// 可选：静默跳过（默认行为），或抛出异常便于客户端监控
// ctx.op = 'noop'; // 显式跳过（OpenSearch 2.11+ 支持）
// throw new RuntimeException('Stale update rejected: new timestamp ' + params.updateTimestamp + ' <= existing ' + ctx._source.updateTimestamp);
}
""",
"params": {
"updateTimestamp": 1718294400000,
"title": "Updated Title",
"content": "New content body"
}
}
}? 关键说明：ctx._source 是当前文档的原始 JSON 内容；params 是请求中传入的键值对，支持任意字段；脚本内 ctx.op = 'noop'（OpenSearch ≥2.11）可显式跳过更新并返回 200 OK + "result": "noop"，比抛异常更轻量；若需统计“被拒绝的陈旧更新”，建议在应用层捕获 result: "noop" 或日志中解析响应体。
⚠️ 注意事项与最佳实践
-
字段存在性校验：若 updateTimestamp 字段可能缺失（如首次写入），建议在脚本开头添加防御逻辑：
if (!ctx._source.containsKey('updateTimestamp') || params.updateTimestamp > ctx._source.updateTimestamp) { ... } - 性能考量：Painless 脚本运行于服务端 JVM，复杂逻辑会影响吞吐量；本例为轻量比较+赋值，性能影响极小。
- 原子性保障：OpenSearch 的 _update + 脚本是原子操作，无需额外加锁。
-
替代方案对比：
- ❌ get-then-update（读-改-写）：引发竞态条件与额外网络开销；
- ❌ if_seq_no/if_primary_term：无法关联业务时间维度，仅保证写入顺序；
- ✅ 脚本更新：业务逻辑内聚、原子、零竞态、低延迟。
✅ 进阶建议：复用脚本（Stored Script）
为提升可维护性与执行效率，可将脚本预存为 stored script：
PUT /_scripts/timestamp_guarded_update
{
"script": {
"lang": "painless",
"source": "...（同上脚本内容）..."
}
}调用时简化为：
POST /test_index/_update/123
{
"scripted_upsert": true,
"script": {
"id": "timestamp_guarded_update",
"params": { "updateTimestamp": 1718294400000, "title": "..." }
},
"upsert": { "updateTimestamp": 1718294400000, "title": "Initial Title" }
}（upsert 确保文档不存在时也能初始化时间戳）
通过该方案，你无需依赖外部插件或升级集群，即可在 OpenSearch 中稳健实现基于业务时间戳的“外部版本”语义，兼顾正确性、性能与可运维性。
