API请求头读取时区始终返回Etc/UTC，本地运行正常求解决方案

你的代码核心问题在于：当请求头没有timezone时，你用了ZoneId.systemDefault()——这个方法返回的是服务器的系统时区，不是客户端的。本地运行时，服务器就是你的电脑，时区和客户端一致；但部署到线上服务器后，服务器默认时区通常是UTC（即Etc/UTC），所以会返回错误的时区。

要获取客户端时区，必须让客户端主动传递时区信息，不能依赖服务器时区。以下是具体实现方案：

1. 强制客户端传递标准时区请求头 #

修改代码，要求请求必须携带timezone请求头，且值为标准的时区ID（如Asia/Shanghai、Europe/London），同时兼容GMT偏移格式（如GMT+8）：

private ZoneId getRequestTimeZone(ServerRequest request) {
    // 读取timezone请求头
    List<String> timezoneHeaders = request.headers().header("timezone");

    if (!timezoneHeaders.isEmpty()) {
        String timezoneValue = timezoneHeaders.get(0);
        try {
            // 解析标准时区ID（优先推荐）
            return ZoneId.of(timezoneValue);
        } catch (DateTimeException e) {
            // 兼容GMT偏移格式
            if (timezoneValue.startsWith("GMT")) {
                return ZoneId.of(timezoneValue);
            }
            // 格式错误返回400
            throw new ResponseStatusException(
                    HttpStatus.BAD_REQUEST,
                    "无效时区：" + timezoneValue + "，请使用标准时区ID（如Asia/Shanghai）或GMT格式（如GMT+8）"
            );
        }
    } else {
        // 缺少请求头直接返回错误，避免用服务器时区产生歧义
        throw new ResponseStatusException(
                HttpStatus.BAD_REQUEST,
                "缺少必填请求头：timezone，请提供有效的时区ID"
        );
    }
}

2. 客户端如何获取正确的时区值 #

• Android：使用TimeZone.getDefault().getID()，会返回标准时区ID（如Asia/Shanghai）
• iOS：使用TimeZone.current.identifier，返回值同样符合标准格式
• Postman测试：在请求头中添加timezone: Asia/Shanghai即可

3. 备选方案：从URL参数获取时区 #

如果客户端不方便传递请求头，可以改为从URL参数读取：

private ZoneId getRequestTimeZone(ServerRequest request) {
    // 从URL参数读取timezone
    String timezoneParam = request.queryParam("timezone").orElse(null);
    
    if (timezoneParam != null) {
        try {
            return ZoneId.of(timezoneParam);
        } catch (DateTimeException e) {
            throw new ResponseStatusException(
                    HttpStatus.BAD_REQUEST,
                    "无效时区：" + timezoneParam
            );
        }
    } else {
        throw new ResponseStatusException(
                HttpStatus.BAD_REQUEST,
                "缺少必填参数：timezone"
        );
    }
}

• 不要让客户端传递纯数字偏移（如8），因为时区存在夏令时调整，纯偏移无法自动适配，标准时区ID会自动处理夏令时变化
• 永远不要依赖服务器时区来代替客户端时区，服务器时区是部署环境决定的，和客户端无关

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