如何通过Node.js Elasticsearch API实现文档Upsert？

你观察得没错！目前Node.js官方Elasticsearch客户端实现文档upsert（更新或插入）最直接且推荐的方式，就是通过update接口的upsert选项。

为什么是update接口的upsert？ #

Upsert的核心语义是：如果目标ID的文档存在，则执行更新逻辑；如果不存在，则插入新文档。官方客户端的update接口专门设计了upsert参数来实现这个原子操作——整个逻辑由Elasticsearch服务器端处理，避免了客户端先判断文档存在性再执行操作的竞态问题，效率更高。

快速代码示例（以v8+客户端为例） #

这里给你一个可直接参考的实现：

const { Client } = require('@elastic/elasticsearch');
// 初始化客户端
const client = new Client({ node: 'http://localhost:9200' });

async function runUpsert() {
  try {
    const response = await client.update({
      index: 'your_target_index', // 你的索引名
      id: 'target_document_id',   // 目标文档ID
      // 当文档存在时，要更新的字段（支持部分更新）
      doc: {
        last_updated: new Date().toISOString(),
        views: 100
      },
      // 当文档不存在时，要插入的完整文档内容
      upsert: {
        title: 'New Article',
        content: 'Initial content for new document',
        created_at: new Date().toISOString(),
        views: 100
      }
    });
    console.log('Upsert操作完成:', response);
  } catch (err) {
    console.error('Upsert操作失败:', err);
  }
}

runUpsert();

有没有其他实现方式？ #

理论上你可以通过客户端先调用get接口判断文档是否存在，再分别调用update或index接口，但这种方式需要两次请求，而且在高并发场景下可能出现竞态（比如判断文档不存在后，插入前被其他请求创建了文档），所以不推荐。

另外，index接口的默认行为是“插入或替换”——如果ID存在会直接替换整个文档，这和upsert“更新部分字段”的语义不同，所以不能直接用来实现需求中的upsert。

总结来说，官方推荐的最优方案就是使用update接口的upsert选项，这也是目前最简洁可靠的实现方式。

内容的提问来源于stack exchange，提问作者Zhen Liu