OpenAPI Generator生成前后端API时的时区错乱问题求助

前端通过toISOString()生成的是UTC时区的ISO格式字符串（比如用户输入GMT+2的10:00，会被转成2024-05-20T08:00:00.000Z），但后端用LocalDateTime接收时，@DateTimeFormat(iso = ISO.DATE_TIME)默认会忽略字符串中的时区标记（Z），直接按服务器本地时区解析该时间，导致最终存储的时间比用户输入早2小时；date类型字段同理，UTC日期被按本地时区解析为LocalDate，出现日期提前一天的问题。

方案一：后端配置全局时区解析规则（推荐） #

在Spring配置文件（application.yml或application.properties）中添加以下配置，让Jackson正确识别输入字符串的时区信息，并转换为目标时区的时间：

spring:
  jackson:
    time-zone: Europe/Berlin # 替换为用户所在时区，比如GMT+2对应的Europe/Berlin
    deserialization:
      adjust-dates-to-context-time-zone: true
  mvc:
    format:
      date-time: yyyy-MM-dd'T'HH:mm:ss.SSSXXX

同时调整Model字段的注解，用@JsonFormat替代@DateTimeFormat，显式指定解析格式和时区：

@Valid
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "Europe/Berlin")
private LocalDate creationDate;

@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX", timezone = "Europe/Berlin")
private LocalDateTime from;

@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd'T'HH:mm:ss.SSSXXX", timezone = "Europe/Berlin")
private LocalDateTime to;

这样后端会自动将前端传来的UTC时间字符串，转换为指定时区的LocalDate/LocalDateTime，与用户输入完全一致。

方案二：后端改用带时区的时间类型 #

修改Gradle中的typeMappings，将date-time映射为带时区的ZonedDateTime，而非无时区的LocalDateTime：

typeMappings = ['string+date-time': 'ZonedDateTime']
importMappings = ['ZonedDateTime': 'java.time.ZonedDateTime']

生成的Model字段会变为：

@Valid
private LocalDate creationDate;

@DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
private ZonedDateTime from;

@DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
private ZonedDateTime to;

ZonedDateTime会自动解析前端传来的带时区的ISO字符串，存储时可根据需求转换为UTC或指定时区的时间，彻底避免时区解析错误。

方案三：修改OpenAPI Generator前端生成配置 #

如果需要前端生成的代码直接输出本地时区的ISO字符串（不带UTC标记），可以在生成时添加自定义参数或修改模板：

1. 生成命令添加参数（以TypeScript-Axios为例）：

openapi-generator-cli generate -g typescript-axios --additional-properties=dateLibrary=date-fns,serializeDatesWithTimezone=true

2. 或者自定义OpenAPI Generator的模板文件（如model.mustache），将toISOString()替换为本地时区格式化逻辑：

'from': value['from'] == null ? undefined : new Intl.DateTimeFormat('en-US', {
  year: 'numeric',
  month: '2-digit',
  day: '2-digit',
  hour: '2-digit',
  minute: '2-digit',
  second: '2-digit',
  hour12: false,
  timeZone: 'Europe/Berlin'
}).format(value['from']).replace(/(\d{2})\/(\d{2})\/(\d{4})/, '$3-$2-$1').replace(' ', 'T')

此方案需维护自定义模板，适合需要前端严格控制时区输出的场景。

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