Java OpenAPI生成器客户端解析无时区偏移日期报错问题咨询

默认配置的openapi-generator Java客户端（搭配java8时间库）不支持直接解析无时区偏移的ISO日期字符串：生成器默认将OpenAPI规范的date-time类型映射为OffsetDateTime，内置的解析器严格要求输入必须携带时区偏移段，你拿到的输入字符串在毫秒位（索引22）就结束，缺失偏移信息所以抛出解析异常。
你可以根据实际场景选以下适配方案：

• 自定义宽松日期反序列化器（推荐，侵入性最小）
  生成器默认使用Gson或Jackson做JSON序列化，你只需要替换默认的OffsetDateTime类型适配器，实现兼容带/不带时区的解析逻辑即可：解析时优先匹配带偏移的格式，匹配不到时按本地时间解析，再补上接口实际使用的默认时区偏移，转为OffsetDateTime。
  Gson实现示例：

  public class LenientOffsetDateTimeAdapter extends TypeAdapter<OffsetDateTime> {
      private static final DateTimeFormatter LENIENT_PARSER = new DateTimeFormatterBuilder()
              .append(DateTimeFormatter.ISO_LOCAL_DATE_TIME)
              .optionalStart().appendOffsetId().optionalEnd()
              .toFormatter();
      private final ZoneOffset apiDefaultOffset;
  
      // 初始化时传入接口服务端的固定时区偏移，比如UTC传ZoneOffset.UTC
      public LenientOffsetDateTimeAdapter(ZoneOffset apiDefaultOffset) {
          this.apiDefaultOffset = apiDefaultOffset;
      }
  
      @Override
      public void write(JsonWriter out, OffsetDateTime value) throws IOException {
          out.value(value.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME));
      }
  
      @Override
      public OffsetDateTime read(JsonReader in) throws IOException {
          String rawDateStr = in.nextString();
          TemporalAccessor parsed = LENIENT_PARSER.parseBest(rawDateStr, OffsetDateTime::from, LocalDateTime::from);
          if (parsed instanceof OffsetDateTime) {
              return (OffsetDateTime) parsed;
          }
          return ((LocalDateTime) parsed).atOffset(apiDefaultOffset);
      }
  }
  

  初始化客户端时，把这个适配器注册到生成的JSON实例中，替换原有OffsetDateTime的类型适配器即可生效。
• 全局修改日期类型映射
  如果接口所有date-time字段都不返回时区信息，你可以在生成代码时添加配置，将date-time的映射类型改为LocalDateTime：
  以Maven插件为例，在配置中添加：

  <typeMappings>
      <typeMapping>date-time=LocalDateTime</typeMapping>
  </typeMappings>
  <importMappings>
      <importMapping>LocalDateTime=java.time.LocalDateTime</importMapping>
  </importMappings>
  

  生成的代码会直接用LocalDateTime做日期字段类型，内置解析器不需要时区信息即可完成解析。注意该方案会全局生效，如果接口有部分字段返回带时区的时间，会丢失时区偏移信息。
• 自定义代码生成模板
  如果需要长期生成代码、不想每次生成后手动修改注册适配器，可以把openapi-generator内置的JSON类型适配器模板拷贝到本地，修改日期解析逻辑为上述宽松解析模式，生成代码时通过templateDir参数指定自定义模板目录，生成的代码会自带兼容解析能力。

注意：给无时区日期补默认偏移前，务必和接口提供方确认服务端使用的固定时区，不要直接使用客户端运行环境的默认时区，避免跨环境部署出现时间计算错误。

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