REST API开发疑问：Go语言中PATCH请求空体的处理方式

结论先行：应该返回 400 Bad Request（4XX类错误状态码）

我来拆解一下为什么这么做，结合REST语义、RFC规范和实际开发场景来说：

• 从PATCH的设计意图出发：PATCH方法的核心是部分更新资源，它要求客户端提供一组明确的修改指令（在你的场景里就是Name或Email字段）。空请求体意味着没有任何更新操作的指令，这完全违背了PATCH的使用目的——客户端发送这样的请求本身就是一个错误，因为它没有传递任何有意义的操作内容。

• 参考RFC 5789的隐含逻辑：虽然你提到RFC 5789的2.2节没有直接明确空请求体的处理，但文档里反复强调PATCH请求需要包含“修改资源的指令集”。空请求体等于没有提供任何指令，属于客户端请求格式不符合要求的情况，刚好匹配400 Bad Request的适用场景：请求语法错误或无法被服务器理解。

• 实际开发的一致性与用户体验：返回4XX错误能清晰地告诉客户端“你的请求有问题，必须提供至少一个要更新的字段”。如果错误地返回2XX（比如204 No Content），客户端可能会误以为更新操作成功完成，但实际上资源没有任何变化，这会造成逻辑混淆，甚至导致客户端后续流程出错。

结合你用Go开发的场景，这里给个简单的处理示例，用来检查空请求体的情况：

func handleUserPatch(w http.ResponseWriter, r *http.Request) {
    // 用map接收请求体，方便检查是否有有效字段
    var updatePayload map[string]interface{}
    err := json.NewDecoder(r.Body).Decode(&updatePayload)
    if err != nil {
        http.Error(w, "Invalid request body format", http.StatusBadRequest)
        return
    }

    // 检查是否没有任何可更新的字段
    if len(updatePayload) == 0 {
        http.Error(w, "PATCH request must include at least one field (Name or Email) to update", http.StatusBadRequest)
        return
    }

    // 后续执行实际的用户更新逻辑...
    // 比如根据ID找到用户，更新对应字段，保存到数据库等

    w.WriteHeader(http.StatusOK)
    // 返回更新后的用户信息，或者根据需求返回204（如果不需要返回内容，但前提是更新操作确实执行了）
    json.NewEncoder(w).Encode(updatedUser)
}

补充一句：偶尔会看到有人考虑返回204，但这是不合理的——204的语义是“请求成功执行，且不需要返回内容”，但这里的问题是请求本身就不符合要求，根本没有执行任何更新操作，所以不能用成功状态码。

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