could not parse month times expected an object but found - 如何解决此 Elasticsearch 异常 | Easysearch | 分布式搜索型数据库

适用版本： 6.8-8.9

1. 错误异常的基本描述 #

could not parse month times. expected an object; but found [token] 是 Elasticsearch Watcher 在解析 monthly schedule（月度调度）配置时抛出的异常。当 times 字段的值不是解析器期望的对象结构时，就会触发此错误。

monthly schedule 需要描述月份中的第几天和具体时间，因此 times 必须是包含 day 和 time 等子字段的对象，不能是简单的字符串或数字。

常见现象 #

创建或更新 watch 时返回 HTTP 400 错误。
报错信息明确指出实际找到的 token 类型（如 VALUE_STRING、VALUE_NUMBER 等）。
常见于手动编写复杂的 monthly schedule 配置时，或在使用模板生成配置时。
如果配置由 UI 或模板自动生成，可能出现对象被序列化为字符串的问题。

典型报错与异常栈 #

{
  "error": {
    "root_cause": [
      {
        "type": "parse_exception",
        "reason": "could not parse month times. expected an object; but found [VALUE_STRING]"
      }
    ],
    "type": "parse_exception",
    "reason": "could not parse month times. expected an object; but found [VALUE_STRING]"
  },
  "status": 400
}

服务端日志中可能出现类似以下内容：

[2024-01-15T10:30:00,123][WARN ][o.e.x.w.s.MonthTimes   ] [node-1] failed to parse month times
ElasticsearchParseException[could not parse month times. expected an object; but found [VALUE_STRING]]
    at org.elasticsearch.xpack.watcher.trigger.schedule.MonthTimes.parse(MonthTimes.java:67)
    at org.elasticsearch.xpack.watcher.trigger.schedule.MonthlySchedule.parse(MonthlySchedule.java:89)

2. 为什么会发生这个错误 #

MonthTimes.parse 方法期望 times 字段的值是一个 JSON 对象（START_OBJECT token）。如果传入的是其他类型（如字符串、数字、数组等），就会抛出此异常。

常见原因包括：

JSON 结构错误：times 被写成了字符串或数字，而不是对象。例如："times": "1st" 应该是 "times": {"day": 1, "time": "12:00"}。
模板渲染问题：使用 Mustache 或 script 模板时，渲染结果可能不是合法的对象结构。
序列化问题：如果配置由程序自动生成，序列化过程可能把对象压扁成了字符串。
复制粘贴错误：从其他配置复制时，可能遗漏了对象的大括号 {}。
字段类型混淆：把应该是对象的字段写成了数组或字符串。
版本差异：不同版本的 Watcher 对 times 结构的要求可能不同。

3. 如何排查和解决这个异常和解决这个异常 #

排查步骤 #

确认报错信息中的 token 类型：从错误信息中提取实际找到的 token 类型（found [token]），判断是字符串、数字还是其他类型。
检查 Watch 中的 monthly schedule 配置：

# 获取 watch 配置
GET _watcher/watch/<watch_id>?pretty

# 检查 trigger 部分的 monthly schedule

验证 times 字段的结构：确认 times 是对象类型，且包含必需的子字段。

# 正确的 monthly schedule 结构示例
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "monthly": {
        "times": [
          {
            "day": 1,
            "time": "12:00"
          },
          {
            "day": 15,
            "time": "18:00"
          }
        ]
      }
    }
  },
  ...
}

检查模板渲染结果：如果使用动态模板，先渲染模板确认结果是否是合法的对象结构。

排查时需要注意的问题 #

注意 times 是一个数组，数组中的每个元素都是对象（包含 day 和 time 字段）。
如果使用了模板变量，确保变量渲染后不会产生字符串或其他非对象类型。
检查 JSON 格式是否正确，特别是对象的大括号 {} 是否配对。

4. 如何解决这个错误 #

常用修复思路 #

恢复 times 的对象结构：确保 times 是包含 day 和 time 字段的对象数组。

# 修复前（错误：times 是字符串）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "monthly": {
        "times": "1st day at 12:00"  # 错误
      }
    }
  }
}

# 修复后（正确：times 是对象数组）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "monthly": {
        "times": [
          {
            "day": 1,
            "time": "12:00"
          }
        ]
      }
    }
  }
}

使用最小样板验证：先用最简单的 monthly schedule 配置测试，确认结构正确后再扩展。

# 最小可工作的 monthly schedule
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "monthly": {
        "times": [
          {
            "day": 1,
            "time": "00:00"
          }
        ]
      }
    }
  },
  "input": {...},
  "actions": {...}
}

检查模板生成逻辑：如果使用程序生成配置，确保序列化过程正确保留对象结构。

后续注意事项与推荐建议 #

在编写 monthly schedule 配置时，严格参照官方文档中的示例。
对动态生成的配置进行结构验证，确保 times 是合法的对象数组。
在测试环境验证 schedule 配置，特别是在使用模板或程序生成配置时。

借助 INFINI 产品提升排障效率 #

INFINI Console 提供可视化的 Watch 编辑和验证功能，可以在保存前检查 schedule 配置的合法性，自动检测结构错误。
INFINI Gateway 可以记录 Watcher API 的完整请求内容，帮助捕获 schedule 配置的详细错误上下文，并通过流量回放验证修复方案。
通过 INFINI Console 的 Watch 测试功能，可以在不执行完整 Watch 的情况下验证 schedule 配置的合法性。

5. 小结 #

could not parse month times. expected an object; but found [token] 是一个结构类型错误，表示 monthly schedule 的 times 字段不是期望的对象结构。解决此问题的关键是：确认 times 是包含 day 和 time 字段的对象数组，修复 JSON 结构错误。

通过 INFINI Console 的配置验证功能和 INFINI Gateway 的请求捕获能力，可以更高效地定位和修复 monthly schedule 的结构问题。

参考文档 #

附：日志上下文 #

下面保留当前页面中的源码或日志片段，便于继续结合异常调用栈定位问题：

public static MonthTimes parse(XContentParser parser, XContentParser.Token token) throws IOException, ElasticsearchParseException {
    if (token != XContentParser.Token.START_OBJECT) {
        throw new ElasticsearchParseException("could not parse month times. expected an object; but found [{}]", token);
    }

标签

could not parse month times expected an object but found - 如何解决此 Elasticsearch 异常