
本文详解如何将 java 枚举字段序列化为标准 json 格式,并在 postman 中准确提交,避免 400 错误;核心在于确保枚举以字符串字面量(如 `"men"`)形式传输,而非对象或数字。
在 Spring Boot 或基于 Jackson 的 REST API 中,Java 枚举默认会被序列化为其名称的字符串形式(如 Type.MEN → "MEN"),前提是未自定义序列化逻辑(如 @JsonValue 或 @JsonCreator)。因此,你无需修改不可变的 Request 类,只需在 Postman 中发送符合 Jackson 默认约定的 JSON 即可。
✅ 正确的 JSON 格式(Postman Body)
对于你的 Request 类,对应的有效 JSON 请求体如下(Content-Type: application/json):
{
"num": 123,
"type": "MEN"
}其他合法枚举值示例:
- "type": "WOMEN"
- "type": "FAMILY"
- "type": "CHILD"
⚠️ 常见错误导致 400 的原因:
立即学习“Java免费学习笔记(深入)”;
- ❌ 发送 "type": "men"(大小写不匹配 — Java 枚举名严格区分大小写);
- ❌ 发送 "type": 0 或 "type": {"name": "MEN"}(Jackson 默认不接受序号或对象);
- ❌ 忘记设置 Postman 的 Content-Type 请求头为 application/json;
- ❌ 后端启用了 DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES,而 JSON 中存在多余字段。
? 验证 JSON 格式的推荐方法
最可靠的方式是在本地用 Jackson 序列化一个实例,生成“黄金标准”JSON:
import com.fasterxml.jackson.databind.ObjectMapper;
public class JsonTest {
public static void main(String[] args) throws Exception {
ObjectMapper mapper = new ObjectMapper();
Request request = new Request(Request.Type.MEN, 42);
String json = mapper.writeValueAsString(request);
System.out.println(json); // 输出:{"num":42,"type":"MEN"}
}
}添加依赖(Maven):
com.fasterxml.jackson.core jackson-databind 2.15.3
? 提示:若项目已引入 MgntUtils,也可用更简洁的工具类:String json = JsonUtils.writeObjectToJsonString(new Request(Request.Type.FAMILY, 99));
? 注意事项与最佳实践
- 不要手动拼写 JSON:始终通过代码序列化验证格式,避免手误;
- 检查后端枚举映射逻辑:确认服务端未使用 @JsonFormat(shape = JsonFormat.Shape.OBJECT) 等非常规配置;
- 启用日志调试:在 Spring Boot 中添加 logging.level.com.fasterxml.jackson=DEBUG,观察反序列化过程;
-
Postman 设置检查清单:
- ✔️ Body → raw → JSON(而非 form-data 或 text);
- ✔️ Headers 中 Content-Type: application/json 已显式设置;
- ✔️ URL 正确,HTTP 方法为 POST(或对应接口要求的方法)。
只要 JSON 结构与 Jackson 默认行为一致,且后端未做特殊定制,"type": "MEN" 这一形式即可被正确反序列化为 Request.Type.MEN 实例,彻底解决 400 Bad Request 问题。










