我来帮你搞定这个Zabbix API查询的坑！你的问题根源在于：Zabbix里参数化的指标（比如网络接口相关的），存储的name字段是带变量占位符的（比如Incomming network traffic on $1），而你传入的是替换后的完整显示名（Incomming network traffic on lan900），直接用精确匹配filter自然找不到对应item，所以报错。

最优解决方案：使用expandName参数展开指标名 #

Zabbix API的item.get方法提供了expandName参数，开启后会自动将指标名中的变量占位符替换为实际的参数值（比如把$1换成lan900），这样你就能直接用用户看到的完整显示名来精确匹配了。

修改后的Java方法如下：

protected String getItemId(String host, String zabbixHostItemDisplayName) {
    JSONObject hostItemsFilter = new JSONObject();
    hostItemsFilter.put("name", new String[]{zabbixHostItemDisplayName});

    JSONResponse response = connectZabbix.zabbixAPI.call(RequestBuilder.newBuilder()
            .method("item.get")
            .paramEntry("filter", hostItemsFilter)
            .paramEntry("expandName", true) // 关键：展开带变量的指标名
            .paramEntry("host", host)
            .build());

    JSONArray result = response.getJSONArray("result");
    // 增加边界检查，避免空指针或多个匹配的情况
    if (result.length() == 0) {
        throw new RuntimeException("未找到主机[" + host + "]对应的指标：" + zabbixHostItemDisplayName);
    } else if (result.length() > 1) {
        throw new RuntimeException("主机[" + host + "]存在多个匹配的指标：" + zabbixHostItemDisplayName);
    }

    return result.getJSONObject(0).getString("itemid");
}

对应的请求体变成这样：

{
  "jsonrpc": "2.0",
  "method": "item.get",
  "params": {
    "filter": {
      "name": [ "Incomming network traffic on lan900" ]
    },
    "host": "myHost",
    "expandName": true
  }
}

为什么这个方案有效？ #

• 开启expandName: true后，Zabbix会返回替换了变量后的实际显示名，而不是存储的模板名
• 你依然可以用原来的filter进行精确匹配，保证查询结果的准确性
• 增加了边界检查，避免因无匹配结果或多个匹配结果导致的数组越界异常

备选方案：模糊匹配（如果不需要严格精确） #

如果你不想依赖expandName，也可以用search参数配合通配符进行模糊匹配，比如：

protected String getItemId(String host, String zabbixHostItemDisplayName) {
    JSONObject searchParams = new JSONObject();
    // 用%作为通配符匹配任意字符，这里也可以直接传完整名称做模糊匹配
    searchParams.put("name", zabbixHostItemDisplayName);

    JSONResponse response = connectZabbix.zabbixAPI.call(RequestBuilder.newBuilder()
            .method("item.get")
            .paramEntry("search", searchParams)
            .paramEntry("host", host)
            .build());

    // 同样需要做边界检查
    JSONArray result = response.getJSONArray("result");
    if (result.length() == 0) {
        throw new RuntimeException("未找到匹配的指标");
    }
    return result.getJSONObject(0).getString("itemid");
}

不过这种方式可能会匹配到多个相似的指标，不如expandName的精确匹配可靠。

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