Java中如何区分PUT请求里显式设为null与未传入的JSON字段

核心思路是直接操作原始请求的JSON结构，通过检查字段的存在性来区分：如果字段在JSON中存在但值为null，就是显式设为null；如果字段完全不在JSON里，就是未传入。以下是不同技术栈的具体实现方式：

Java（Spring Boot） #

方式1：用JsonNode接收原始请求体 #

直接解析请求为JsonNode，通过has()判断字段是否存在，isNull()判断是否为显式null：

@PutMapping("/users/{id}")
public ResponseEntity<?> updateUser(@PathVariable Long id, @RequestBody JsonNode requestBody) {
    // 判断middleName字段是否存在
    if (requestBody.has("middleName")) {
        boolean isNullValue = requestBody.get("middleName").isNull();
        if (isNullValue) {
            // 处理显式设为null的逻辑：将数据库对应字段更新为null
        } else {
            // 处理更新字段值的逻辑：使用requestBody.get("middleName").asText()获取值
        }
    } else {
        // 字段未传入：不更新该字段
    }
    return ResponseEntity.ok().build();
}

方式2：用Map<String, Object>接收请求体 #

通过containsKey()检查字段是否存在，再判断值是否为null：

@PutMapping("/users/{id}")
public ResponseEntity<?> updateUser(@PathVariable Long id, @RequestBody Map<String, Object> requestBody) {
    if (requestBody.containsKey("middleName")) {
        Object middleNameVal = requestBody.get("middleName");
        if (middleNameVal == null) {
            // 显式设为null的处理逻辑
        } else {
            // 更新字段值的逻辑
        }
    } else {
        // 字段未传入，不更新
    }
    return ResponseEntity.ok().build();
}

Python（FastAPI） #

方式1：接收原始JSON字典 #

通过in关键字检查字段是否存在：

from fastapi import FastAPI, Request

app = FastAPI()

@app.put("/users/{user_id}")
async def update_user(user_id: int, request: Request):
    req_body = await request.json()
    if "middleName" in req_body:
        middle_name = req_body["middleName"]
        if middle_name is None:
            # 显式设为null的处理逻辑
        else:
            # 更新字段值的逻辑
    else:
        # 字段未传入，不更新
    return {"status": "success"}

方式2：用Pydantic模型区分未传入与null #

通过Field(default=Undefined)标记字段，未传入时值为Undefined，显式传null时为None：

from pydantic import BaseModel, Field, Undefined
from fastapi import FastAPI

class UpdateUserReq(BaseModel):
    firstName: str
    middleName: str | None = Field(default=Undefined)
    lastName: str
    location: str

app = FastAPI()

@app.put("/users/{user_id}")
async def update_user(user_id: int, req: UpdateUserReq):
    if req.middleName is not Undefined:
        if req.middleName is None:
            # 显式设为null的处理逻辑
        else:
            # 更新字段值的逻辑
    else:
        # 字段未传入，不更新
    return {"status": "success"}

Node.js（Express） #

直接检查请求体对象的字段存在性：

const express = require('express');
const app = express();
app.use(express.json());

app.put('/users/:id', (req, res) => {
    const reqBody = req.body;
    if ('middleName' in reqBody) {
        if (reqBody.middleName === null) {
            // 处理显式设为null的逻辑
        } else {
            // 处理更新字段值的逻辑
        }
    } else {
        // 字段未传入，不更新
    }
    res.status(200).send({ status: 'success' });
});

app.listen(3000, () => console.log('Server running on port 3000'));

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