Elasticsearch JS脚本更新文档报错：变量[x]未定义如何解决？

咱先捋清楚问题根源：你遇到的"Variable [x] is not defined"错误，基本是因为脚本引用参数的方式不对，或者请求结构没匹配ES 6.x版本的规则。下面直接给你可行的解决方法和代码示例：

1. 正确的JavaScript客户端更新代码 #

假设你的索引名是test_index，要更新的文档ID是123，正确的代码应该是这样的：

const { Client } = require('elasticsearch');
const client = new Client({
  host: 'http://localhost:9200', // 替换成你的ES服务地址
  apiVersion: '6.1' // 必须指定和服务器匹配的API版本，这步很关键！
});

async function updateDocumentLength() {
  try {
    const result = await client.update({
      index: 'test_index',
      id: '123',
      body: {
        script: {
          source: 'ctx._source.length = params.targetLength;', // 必须用params.前缀引用参数
          params: {
            targetLength: 100 // 这里传递要设置的length值
          }
        }
      }
    });
    console.log('更新成功:', result);
  } catch (err) {
    console.error('更新出错:', err);
  }
}

updateDocumentLength();

2. 你之前报错的核心原因 #

大概率是这几个点踩坑了：

• 脚本里直接用变量名而非params.前缀：比如你可能写了ctx._source.length = length;，但ES 6.x的Painless脚本不会把params里的变量自动暴露为全局变量，必须显式用params.xxx来引用。
• 未指定匹配的API版本：你用的JS客户端是v14.1.0，这个版本兼容多个ES版本，但如果不指定apiVersion: '6.1'，客户端可能会用高版本的API格式，和ES 6.1.1不兼容，导致参数传递失败。
• 参数位置放错：比如你把params放到了body根节点下，而不是嵌套在script节点里，ES根本接收不到参数，自然会报变量未定义。

3. 额外验证小技巧 #

可以先在Kibana的Dev Tools里用REST请求测试脚本是否可行，没问题再转成JS代码：

POST test_index/_update/123
{
  "script": {
    "source": "ctx._source.length = params.targetLength",
    "params": {
      "targetLength": 100
    }
  }
}

这个请求能成功的话，再对应调整JS客户端的代码就不会有问题了。另外要确保ES集群默认允许Painless脚本（6.x默认是开启的，除非你修改过elasticsearch.yml里的脚本权限配置）。

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