springboot controller 时区

### 处理Spring Boot Controller中的时区问题 在构建Web应用程序时，正确处理时间与时区非常重要。对于基于Spring Boot的应用程序，在`Controller`层处理时区可以通过多种方式实现。 #### 使用HTTP头设置默认时区 一种简单的方法是在请求到达控制器之前通过过滤器来修改线程上下文的时间区域属性。这通常涉及到读取来自客户端的特定头部信息（比如`TimeZone`），并将其应用于当前线程： ```java import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import java.util.TimeZone; @Component public class TimeZoneFilter implements Filter { @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest httpRequest = (HttpServletRequest) request; String timeZoneId = httpRequest.getHeader("X-Time-Zone"); if (timeZoneId != null && !timeZoneId.isEmpty()) { TimeZone.setDefault(TimeZone.getTimeZone(timeZoneId)); } try { chain.doFilter(request, response); } finally { // Reset the default time zone after processing. TimeZone.setDefault(null); } } } ``` 这种方法允许开发者根据传入请求动态调整服务器端操作所使用的时区[^1]。 #### 利用@DateTimeFormat注解指定日期格式及时区 当接收带有日期字段的对象作为参数时，可以利用`@DateTimeFormat`注解来指定期望输入的数据格式以及对应的时区。这样做的好处是可以让框架自动完成字符串到Java `Date`, `Calendar`, 或者Joda Time类型的转换工作，并考虑到了不同的地区差异： ```java @PostMapping("/post") public ResponseEntity<?> createPost(@ModelAttribute Post post, BindingResult bindingResult) { // Validate and process 'post' entity... } // In your model/entity class definition: private LocalDateTime createdOn; @DateTimeFormat(iso = ISO.DATE_TIME, pattern="yyyy-MM-dd'T'HH:mm:ssZ", isoPattern=true) public void setCreatedOn(LocalDateTime createdOn){ this.createdOn = createdOn.withZoneSameInstant(ZoneId.of("Asia/Shanghai")); } ``` 这里展示了如何结合自定义setter方法与`@DateTimeFormat`一起使用，从而确保接收到的时间戳被正确解释为上海所在的东八区时间[^2]。 #### 返回JSON响应时控制时区 为了使返回给前端用户的JSON数据包含正确的本地化时间表示形式，可以在序列化过程中应用Jackson库提供的特性之一——`ObjectMapper`配置项。具体来说就是注册一个新的模块用于支持JSR-310 API下的类(`LocalDateTime`, etc.)，并通过设定`SerializationFeature.WRITE_DATES_AS_TIMESTAMPS`选项关闭以毫秒数输出的方式转而采用ISO8601标准格式加上偏移量的形式展示时间点： ```yaml spring: jackson: serialization.write_dates_as_timestamps: false date-format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX ``` 上述YAML片段应该放置于项目的`application.yml`文件内；如果偏好`.properties`风格，则相应地改为键值对表达即可。