DateTimeFormatterBuilder追加多个可选ISO格式触发DateTimeParseException问题

根因分析 #

appendOptional的执行逻辑并非多数人预期的「多个可选格式为或关系，会自动尝试所有格式取完全匹配结果」，实际运行规则如下：

• 多个appendOptional配置是顺序拼接、贪心匹配的关系，而非多选一的关系
• 解析器会按照追加顺序依次尝试匹配每个可选格式：只要当前格式能匹配字符串前缀部分，就直接消耗对应长度的字符，再用下一个可选格式匹配剩余字符串，不会因为后续存在未解析内容回滚前面的匹配结果

对应你最初的代码场景：
第一个追加的可选格式为ISO_LOCAL_DATE_TIME，该格式不包含时区偏移规则，刚好可以完整匹配2021-10-11T07:00:53.004部分，消耗字符到索引23位置，剩余的Z字符无法被后续两个可选格式匹配（ISO_OFFSET_DATE_TIME要求格式从头包含日期时间+偏移，单独Z无法匹配；ISO_LOCAL_DATE也无法匹配单个Z），最终抛出未解析文本异常。
当你调换追加顺序后，第一个可选格式为ISO_OFFSET_DATE_TIME，可以完整匹配带Z偏移的整串，所以解析成功；但遇到不带偏移的纯本地日期字符串时，前两个格式都会匹配失败，才能轮到第三个ISO_LOCAL_DATE匹配，若中间格式匹配到部分前缀也会出现解析异常。

解决方案说明 #

你拆分ISO格式组件的实现是正确的：按ISO时间的组成结构逐层追加可选部分，先强制匹配日期，再可选匹配T分隔符、时间部分、时区偏移，所有可选部分都是基于已匹配内容向后扩展，不会出现前缀匹配后剩余内容无法解析的问题。
如果需要实现多个完整时间格式的多选一匹配，更简洁的方式是使用DateTimeFormatter的or方法，示例如下：

public class Main {
  public static void main(String[] args) {
    DateTimeFormatter formatter = DateTimeFormatter.ISO_OFFSET_DATE_TIME
            .or(DateTimeFormatter.ISO_LOCAL_DATE_TIME)
            .or(DateTimeFormatter.ISO_LOCAL_DATE);
    LocalDateTime x = LocalDateTime.parse("2021-10-11T07:00:53.004Z", formatter);
    System.out.println("After formatting: " + x);
  }
}

该写法的逻辑是：先尝试用第一个格式匹配整串，匹配失败自动尝试第二个，依次类推，完全符合多选一的需求。 #

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