could not parse time time minute is not a number - 如何解决此 Elasticsearch 异常 | Easysearch | 分布式搜索引擎

适用版本： 6.8-8.9

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

could not parse time [value]. time minute [m] is not a number 是 Elasticsearch 在解析时间字符串时抛出的异常。此错误表示时间字符串的 minute 部分（冒号后的部分）不能被解析成整数。

该错误发生在 hh:mm 格式通过初步检查后，minute 片段包含非数字字符时，属于时间字符串的数值解析错误。

常见现象 #

创建或更新 watch 时返回 HTTP 400 错误。
报错信息明确指出时间字符串和无法解析的 minute 片段。
常见于 daily、weekly、monthly 等 schedule 的 at 字段配置中。
如果 minute 片段包含字母、空格、秒数残片或其他非数字字符，就会触发此错误。

典型报错与异常栈 #

{
  "error": {
    "root_cause": [
      {
        "type": "parse_exception",
        "reason": "could not parse time [12:ab]. time minute [ab] is not a number"
      }
    ],
    "type": "parse_exception",
    "reason": "could not parse time [12:ab]. time minute [ab] is not a number"
  },
  "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 [12:ab]. time minute [ab] is not a number]
    at org.elasticsearch.xpack.watcher.trigger.schedule.DayTimes.parse(DayTimes.java:156)
    at org.elasticsearch.xpack.watcher.trigger.schedule.DailySchedule.parse(DailySchedule.java:89)

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

Watcher 的时间解析器在格式通过 hh:mm 初步检查后，会对 minute 字符串（minStr）调用 Integer.parseInt(...) 将其转换为整数。只要 minute 片段包含非数字字符，就会抛出此异常。

常见原因包括：

minute 片段包含字母：例如 12:ab、12:twelve 等。
minute 片段包含空格：例如 12: 00、12:00 等。
minute 片段包含秒数残片：例如 12:00:00（应该是 12:00）等。
minute 片段包含其他非数字字符：例如 12:0.0（小数点）、12:0-0（破折号）等。
模板渲染问题：使用 Mustache 或 script 模板时，渲染结果可能包含非数字字符。
时区后缀：例如 12:00+08:00（整个字符串包含时区，应该只是 12:00）。

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

排查步骤 #

记录错误中的原始 time 和 minute 片段：从错误信息中提取时间值（could not parse time [value]）和无法解析的 minute 片段（time minute [m]）。
检查 Watch 中的 schedule 配置：

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

# 检查 trigger 部分的 schedule 中的 at 字段

检查 minute 部分是否带有空格、字母、秒数残片或其他字符：

# 正确的时间格式示例
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:00", "18:30"]  # 正确：minute 是纯数字
      }
    }
  },
  ...
}

合法的时间格式必须是：

hh:mm 格式：冒号后是纯数字（minute 部分）
minute 部分：0-59 的数字，可以是 1 位或 2 位（如 12:0 或 12:00）
不能有字母、空格、秒数等：只能是数字

若值来自模板拼接，确认冒号后的子串未被污染：

# 错误：模板渲染后 minute 包含字母
# 假设 ctx.minute = "ab"
"at": ["12:{{ctx.minute}}"]  # 渲染后变成 "12:ab"，错误

# 正确：确保 ctx.minute 是纯数字
# 假设 ctx.minute = 0
"at": ["12:{{ctx.minute}}"]  # 渲染后变成 "12:0"，正确

排查时需要注意的问题 #

注意 minute 部分必须是纯数字，不能包含字母、空格、秒数残片等。
如果使用了模板变量，确保变量渲染后只产生数字字符。
检查是否有不可见字符（如制表符、换行符）混入时间字符串。

4. 如何解决这个错误 #

常用修复思路 #

让 minute 片段只包含数字：

# 修复前（错误：minute 包含字母）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:ab"]  # 错误：minute 是 "ab"
      }
    }
  }
}

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

去掉额外字符和错误分隔符：

# 错误：minute 包含秒数
"at": ["12:00:00"]  # 错误

# 正确：只包含小时和分钟
"at": ["12:00"]  # 正确

对时间字符串做更细粒度校验：

# 在生成配置前，先校验 minute 是纯数字
# 伪代码示例
minute = extract_minute(time_string)
if not minute.isdigit():
    raise Error("Minute must be a number")

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

在编写时间配置时，始终确保 minute 部分是纯数字（0-59）。
对动态生成的时间字符串进行格式验证，确保 minute 部分只包含数字字符。
在测试环境验证 schedule 配置，特别是在使用模板或程序生成配置时。

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

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

5. 小结 #

could not parse time [value]. time minute [m] is not a number 是一个时间字符串数值解析错误，表示 minute 片段不能被解析成整数。解决此问题的关键是：让 minute 片段只包含数字（如 12:00 中的 00），去掉额外字符和错误分隔符。

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

参考文档 #

附：日志上下文 #

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

try {
    minute = new int[] { Integer.parseInt(minStr) };
} catch (NumberFormatException nfe) {
    throw new ElasticsearchParseException("could not parse time [{}]. time minute [{}] is not a number", time, minStr);
}

标签

could not parse time time minute is not a number - 如何解决此 Elasticsearch 异常