JSON 数据传输中日期格式化导致 400 错误：解决方案与最佳实践-java教程-PHP中文网

JSON 数据传输中日期格式化导致 400 错误：解决方案与最佳实践

碧海醫心

发布： 2025-10-21 09:35:01

原创

974人浏览过

JSON 数据传输中日期格式化导致 400 错误：解决方案与最佳实践

本文旨在解决在向后端发送包含日期对象的 json 数据时遇到的 400 bad request 错误。通过分析问题的常见原因，特别是日期格式化和时区设置，提供详细的解决方案，并给出最佳实践建议，帮助开发者避免类似问题，确保数据传输的准确性和可靠性。重点在于如何正确配置 `@jsonformat` 注解，以及处理时区设置，从而实现前后端日期数据的无缝对接。

在前后端数据交互中，日期时间的处理经常会遇到各种问题，其中一种常见的情况是发送包含日期对象的 JSON 数据到后端时，后端返回 400 Bad Request 错误。这通常是由于日期格式不匹配、时区问题或反序列化失败引起的。本文将深入探讨这个问题，并提供详细的解决方案和最佳实践。

问题分析

当后端接收到包含日期数据的 JSON 请求时，它需要将 JSON 字符串转换为 Java 对象。这个过程称为反序列化。如果 JSON 字符串中的日期格式与后端期望的格式不一致，或者时区信息处理不当，就会导致反序列化失败，从而返回 400 错误。

例如，后端期望的日期格式是 yyyy-MM-dd HH:mm:ss，而前端发送的却是 dd/MM/yyyy HH:mm，或者后端没有正确处理时区信息，都可能导致错误。

解决方案

要解决这个问题，需要确保以下几点：

日期格式一致性： 前后端使用的日期格式必须完全一致。
时区处理： 正确处理时区信息，确保日期时间的准确性。
异常处理： 在后端进行适当的异常处理，以便更好地诊断问题。

使用 @JsonFormat 注解

@JsonFormat 注解是 Jackson 库提供的一个非常有用的工具，可以用于指定日期时间的格式和时区。

import com.fasterxml.jackson.annotation.JsonFormat;
import javax.persistence.*;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;

@Entity
public class Scheduling implements Serializable {
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd/MM/yyyy HH:mm", timezone = "Brazil/East")
    @Temporal(TemporalType.TIMESTAMP)
    @Column(nullable = false, length = 254)
    private Date initialDate;

    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd/MM/yyyy HH:mm", timezone = "Brazil/East")
    @Temporal(TemporalType.TIMESTAMP)
    @Column(nullable = false, length = 254)
    private Date finalDate;

    @ManyToOne
    @JoinColumn(name = "teacher_id")
    private Teacher teacher;

    @ManyToOne
    @JoinColumn(name = "classroom_id")
    private Classroom classroom;

    @ManyToOne
    @JoinColumn(name = "class_id")
    private Class group;

    @ManyToMany
    @JoinTable(name = "equipments_schedulings",
            joinColumns = @JoinColumn(name = "scheduling_id"),
            inverseJoinColumns = @JoinColumn(name = "equipment_id"))
    private List<Equipment> equipments = new ArrayList<>();
}

登录后复制

在这个例子中，@JsonFormat 注解被用于 initialDate 和 finalDate 字段。pattern 属性指定了日期格式为 dd/MM/yyyy HH:mm，timezone 属性指定了时区为 "Brazil/East"。

Alkaid.art

专门为Phtoshop打造的AIGC绘画插件

153

查看详情

重要提示： timezone 属性的值应该是一个常量，不应该在运行时动态设置。可以使用常量字符串来定义时区：

private static final String TIME_ZONE = "Brazil/East";
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd/MM/yyyy HH:mm", timezone = TIME_ZONE);

登录后复制

配置 application.properties

在 application.properties 文件中，可以配置 Jackson 的全局日期时间格式和时区：

spring.jackson.time-zone=Brazil/East
spring.jackson.serialization.write-dates-as-timestamps=false

登录后复制

spring.jackson.time-zone 指定了全局时区。
spring.jackson.serialization.write-dates-as-timestamps=false 禁用了将日期时间序列化为时间戳，而是使用字符串表示。

后端代码示例

以下是一个简单的 Spring Boot 控制器示例，用于接收包含日期数据的 JSON 请求：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SchedulingController {

    @PostMapping("/scheduling")
    public Scheduling createScheduling(@RequestBody Scheduling scheduling) {
        // 处理 scheduling 对象
        System.out.println("Received scheduling: " + scheduling.getInitialDate() + " - " + scheduling.getFinalDate());
        return scheduling;
    }
}

登录后复制

前端代码示例

以下是一个使用 JavaScript 发送 JSON 数据的示例：

const data = {
    "initialDate": "22/11/2022 08:00",
    "finalDate": "22/11/2022 08:45",
    "teacher": {
        "id": 1
    },
    "group": {
        "id": 1
    },
    "classroom": {
        "id": 1
    },
    "equipment": [
        {
            "id": 1
        },
        {
            "id": 2
        }
    ]
};

fetch('/scheduling', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => {
    if (!response.ok) {
        throw new Error('HTTP error ' + response.status);
    }
    return response.json();
})
.then(data => {
    console.log('Success:', data);
})
.catch(error => {
    console.error('Error:', error);
});

登录后复制

最佳实践

统一日期格式： 在整个应用程序中，包括前端和后端，使用统一的日期格式。
显式指定时区： 始终显式指定时区，避免使用默认时区。
使用 ISO 8601 格式： 考虑使用 ISO 8601 格式（例如 yyyy-MM-dd'T'HH:mm:ss.SSSXXX），这是一种国际标准日期格式，可以避免很多潜在的问题。
后端异常处理： 在后端添加适当的异常处理，以便更好地诊断日期时间反序列化错误。
测试： 编写单元测试和集成测试，以确保日期时间处理的正确性。