SpringBoot项目如何为每个请求设置时区且无需修改大量业务代码

你遇到的问题非常典型——现有大量业务代码直接用LocalDateTime.now()、new Date()等方式获取当前时间，想按请求维度设置时区却不想改动业务代码，而用Spring AOP尝试拦截JDK核心类静态方法失败，这其实是因为Spring默认的AOP是基于动态代理实现的，只能拦截Spring容器管理的Bean内部方法，根本无法触达JDK原生类的方法逻辑。下面给你详细分析问题和可行的解决方案：

一、为什么你的AspectJ代码不生效 #

你写的AspectJ切面尝试拦截java.time.LocalDateTime.now()，但这里有个关键误区：Spring集成的AspectJ本质还是Spring AOP，它依赖动态代理机制，只能处理Spring Bean中的方法调用；而JDK核心类（比如java.time下的类）不属于Spring Bean，所以你的切点表达式execution(* java.time.LocalDateTime.now())根本不会触发。

如果一定要用AspectJ拦截JDK类方法，必须使用原生AspectJ的编译时编织（CTW）或加载时编织（LTW），直接修改字节码，但这种方式复杂度高、兼容性风险大，不太推荐作为首选方案。

二、推荐方案：请求拦截器+ThreadLocal+线程上下文时区切换 #

核心思路：Tomcat等Web容器会用独立线程处理每个请求（线程池复用），我们可以在请求开始时，根据请求携带的时区设置当前线程的默认时区，请求结束后再恢复原时区。业务代码里的LocalDateTime.now()等价于LocalDateTime.now(ZoneId.systemDefault())，而ZoneId.systemDefault()会自动使用当前线程的默认时区，完全不需要修改业务代码。

步骤1：定义时区上下文工具类 #

用ThreadLocal存储每个线程的原始时区，确保请求结束后能准确恢复：

public class TimeZoneContextHolder {
    // 存储线程原始时区的ThreadLocal
    private static final ThreadLocal<TimeZone> ORIGINAL_TIME_ZONE_HOLDER = new ThreadLocal<>();

    // 设置当前线程的目标时区，并保存原始时区
    public static void setTargetTimeZone(TimeZone targetTimeZone) {
        ORIGINAL_TIME_ZONE_HOLDER.set(TimeZone.getDefault());
        TimeZone.setDefault(targetTimeZone);
    }

    // 恢复当前线程的原始时区
    public static void restoreOriginalTimeZone() {
        TimeZone originalTimeZone = ORIGINAL_TIME_ZONE_HOLDER.get();
        if (originalTimeZone != null) {
            TimeZone.setDefault(originalTimeZone);
            ORIGINAL_TIME_ZONE_HOLDER.remove();
        }
    }
}

步骤2：编写请求拦截器 #

在请求进入时设置时区，请求结束后强制恢复：

public class TimeZoneInterceptor implements HandlerInterceptor {
    // 假设从请求头"Time-Zone"获取时区，比如"America/Chicago"
    private static final String TIME_ZONE_HEADER = "Time-Zone";

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        String timeZoneStr = request.getHeader(TIME_ZONE_HEADER);
        if (timeZoneStr != null && !timeZoneStr.isEmpty()) {
            try {
                TimeZone targetTimeZone = TimeZone.getTimeZone(timeZoneStr);
                TimeZoneContextHolder.setTargetTimeZone(targetTimeZone);
            } catch (IllegalArgumentException e) {
                // 非法时区， fallback到系统默认
                TimeZoneContextHolder.setTargetTimeZone(TimeZone.getDefault());
            }
        }
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 必须恢复时区，否则线程池复用会导致后续请求时区混乱
        TimeZoneContextHolder.restoreOriginalTimeZone();
    }
}

步骤3：注册拦截器到SpringBoot #

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new TimeZoneInterceptor())
                .addPathPatterns("/**"); // 拦截所有请求
    }
}

验证效果 #

现在你的TestController里的LocalDateTime.now()会自动使用请求头指定的时区：

@GetMapping("/hello")
public String hello() {
    // 这里的输出会自动使用请求头指定的时区，完全不用改业务代码
    System.out.println(LocalDateTime.now());
    return "Hello, pkslow.";
}

发送请求时携带头Time-Zone: America/Chicago，控制台就会输出芝加哥时区的当前时间。

三、方案优势与注意事项 #

1. 完全无侵入：不需要修改任何业务代码，兼容LocalDateTime.now()、new Date()、Calendar.getInstance()等所有依赖系统默认时区的API。
2. 线程安全：通过ThreadLocal存储原始时区，请求结束强制恢复，避免线程池复用导致的时区混乱。
3. 灵活扩展：时区来源可以根据业务调整，比如从请求参数、用户会话、配置中心等获取，不一定局限于请求头。

四、备选方案：原生AspectJ加载时编织（LTW） #

如果一定要用AspectJ拦截JDK类方法，需要启用原生AspectJ的加载时编织：

步骤1：引入AspectJ依赖 #

<dependencies>
    <dependency>
        <groupId>org.aspectj</groupId>
        <artifactId>aspectjrt</artifactId>
        <version>1.9.20.1</version>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 指定AspectJ编织代理 -->
                <agents>
                    <agent>${settings.localRepository}/org/aspectj/aspectjweaver/1.9.20.1/aspectjweaver-1.9.20.1.jar</agent>
                </agents>
            </configuration>
        </plugin>
    </plugins>
</build>

步骤2：启用加载时编织 #

在SpringBoot启动类添加注解：

@SpringBootApplication
@EnableLoadTimeWeaving
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

步骤3：编写原生AspectJ切面 #

@Aspect
public class LocalDateTimeAspect {
    // 存储当前请求的时区
    private static final ThreadLocal<String> REQUEST_TIME_ZONE = new ThreadLocal<>();

    // 拦截所有Controller方法，设置请求时区
    @Before("execution(* com.pkslow.springboot.controller..*.*(..))")
    public void beforeController(JoinPoint joinPoint) {
        // 实际可从HttpServletRequest中获取时区，这里模拟固定值
        REQUEST_TIME_ZONE.set("America/Chicago");
    }

    // 拦截LocalDateTime.now()静态方法
    @Around("execution(* java.time.LocalDateTime.now())")
    public Object aroundLocalDateTimeNow(ProceedingJoinPoint pjp) throws Throwable {
        String timeZone = REQUEST_TIME_ZONE.get();
        if (timeZone != null) {
            return LocalDateTime.now(ZoneId.of(timeZone));
        }
        return pjp.proceed(); // 无指定时区时调用原方法
    }

    // 请求结束清理ThreadLocal
    @After("execution(* com.pkslow.springboot.controller..*.*(..))")
    public void afterController(JoinPoint joinPoint) {
        REQUEST_TIME_ZONE.remove();
    }
}

这种方式直接修改JDK类的字节码，虽然能实现需求，但复杂度高、兼容性风险大，仅推荐在特殊场景下使用。

备注：内容来源于stack exchange，提问作者Mr Z