could not parse time expected string number value or an object but found - 如何解决此 Elasticsearch 异常 | Easysearch | 分布式搜索引擎

适用版本： 6.8-8.9

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

could not parse time. expected string/number value or an object; but found [token] 是 Elasticsearch Watcher 在解析 time 配置时抛出的异常。此错误表示时间配置的入口 token 既不是单个值（字符串或数字），也不是对象结构，而是其他类型（如数组、布尔值等）。

常见现象 #

创建或更新 watch 时返回 HTTP 400 错误。
报错信息明确指出实际找到的 token 类型（如 START_ARRAY、VALUE_BOOLEAN 等）。
常见于 daily、weekly、monthly 等 schedule 的 at 字段配置中。
如果 time 被写成数组、布尔值或其他非标量/对象类型，就容易触发此错误。

典型报错与异常栈 #

{
  "error": {
    "root_cause": [
      {
        "type": "parse_exception",
        "reason": "could not parse time. expected string/number value or an object; but found [START_ARRAY]"
      }
    ],
    "type": "parse_exception",
    "reason": "could not parse time. expected string/number value or an object; but found [START_ARRAY]"
  },
  "status": 400
}

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

[2024-01-15T10:30:00,123][WARN ][o.e.x.w.t.s.DayTimes   ] [node-1] failed to parse time
ElasticsearchParseException[could not parse time. expected string/number value or an object; but found [START_ARRAY]]
    at org.elasticsearch.xpack.watcher.trigger.schedule.DayTimes.parse(DayTimes.java:123)
    at org.elasticsearch.xpack.watcher.trigger.schedule.DailySchedule.parse(DailySchedule.java:89)

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

Watcher 的 DayTimes.parse 方法支持三种时间配置模式：

一个字符串时间值（如 "12:00"）
一个数字时间值（如 1200，表示分钟数）
一个对象，用来分别描述 hour、minute 等子字段

如果遇到数组、布尔值等其他 token，就无法进入后续解析流程，直接抛出 could not parse time 异常。

常见原因包括：

time 被写成数组：例如 "at": [["12:00"]] 应该是 "at": ["12:00"]。
time 被写成布尔值：例如 "at": true 应该是 "at": "12:00"。
time 被写成 null：例如 "at": null。
顶层层级嵌套错误：多了一层或少了一层 JSON 对象。
模板渲染问题：使用 Mustache 或 script 模板时，渲染结果可能不是合法的类型。
JSON 结构错误：字段值类型错误（如应该是字符串但写成了对象）。

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

排查步骤 #

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

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

# 检查 trigger 部分的 schedule

验证 time 值的类型：确认 at 字段的值是字符串、数字或对象。

# 正确的 time 配置示例
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:00", "18:00"]  # at 是数组，但数组元素是字符串
      }
    }
  },
  ...
}

合法的时间值类型：

字符串："12:00"（推荐）
数字：1200（表示分钟数，不推荐）
对象：{"hour": 12, "minute": 0}

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

排查时需要注意的问题 #

注意 at 字段本身是数组，但数组的每个元素必须是字符串、数字或对象类型。
如果使用了模板变量，确保变量渲染后不会产生数组的数组（嵌套数组）。
检查是否有空值、null 或其他非法类型混入数组。

4. 如何解决这个错误 #

常用修复思路 #

修正 time 值的类型：确保时间值是字符串、数字或对象类型。

# 修复前（错误：time 是数组的数组）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": [["12:00"]]  # 错误：嵌套数组
      }
    }
  }
}

# 修复后（正确：at 是字符串数组）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:00"]  # 正确
      }
    }
  }
}

使用合法的时间值格式：

# 合法的时间值格式
# 1. 字符串格式（推荐）
"at": ["12:00", "18:00"]

# 2. 对象格式
"at": [{"hour": 12, "minute": 0}, {"hour": 18, "minute": 0}]

# 3. 数字格式（不推荐，容易混淆）
"at": [1200, 1800]

检查模板生成逻辑：如果使用程序生成配置，确保序列化过程正确生成合法的类型。

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

在编写 time 配置时，始终使用字符串格式的 HH:MM（如 "12:00"）。
对动态生成的配置进行类型验证，确保时间值是合法的类型。
在测试环境验证 schedule 配置，特别是在使用模板或程序生成配置时。

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

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

5. 小结 #

could not parse time. expected string/number value or an object; but found [token] 是一个类型错误，表示时间配置的值类型不合法。解决此问题的关键是：确保时间值是字符串（"12:00"）、数字（1200）或对象（{"hour": 12, "minute": 0}）类型，而不是数组、布尔值或其他类型。

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

参考文档 #

附：日志上下文 #

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

if (token == XContentParser.Token.VALUE_STRING) {
    return DayTimes.parse(parser.text());
}
if (token != XContentParser.Token.START_OBJECT) {
    throw new ElasticsearchParseException("could not parse time. expected string/number value or an object; but found [{}]", token);
}

标签

could not parse time expected string number value or an object but found - 如何解决此 Elasticsearch 异常