基于Java、Spring MVC与MyBatis实现HTTP PUT与PATCH请求的方案探讨

首先明确：PUT和PATCH不只是语义层面的区别，代码实现上也需要对应不同的校验逻辑和前置处理，不过可以复用底层的MyBatis更新逻辑，下面逐个拆解你的问题并给出可落地的方案：

1. Spring MVC中如何实现PATCH请求？ #

Spring MVC原生支持@PatchMapping注解，用法和@PutMapping完全一致，用来标记处理PATCH请求的控制器方法。核心是要在方法中体现"部分更新"的语义——比如只校验必要的字段（如资源ID），不对未传入的字段做强制要求。

2. MyBatis如何适配PATCH请求的处理逻辑？ #

你当前的MyBatis更新语句已经完美适配PATCH请求：

<update id="updateMyBean">
    update My_Bean
    <set>
        <if test="field1 != null">field1 = #{field1},</if>
        <if test="field2 != null">field2 = #{field2},</if>
        <if test="field3 != null">field3 = #{field3},</if>
    </set>
    where id = #{id}
</update>

<set>标签会自动处理字段末尾的逗号，<if>判断只会更新非null的字段，刚好对应"只修改传入的字段"的PATCH语义。

而PUT请求的全量更新，你可以复用同一个语句，但需要通过校验确保客户端传入了完整的资源字段，这样执行时就会覆盖所有字段，符合全量替换的语义。

3. 新增@PatchMapping方法是否可行？ #

可行，但业务逻辑不能完全一致。你给出的示例只是改了注解和方法名，这是不够的，两者的校验逻辑要区分开：

• PUT方法：需要校验资源的所有必填字段都已传入（确保是全量更新），如果客户端遗漏字段，应该直接返回参数错误；
• PATCH方法：只需要校验资源ID存在，以及传入的字段格式合法即可，未传入的字段不做强制要求。

这里给你结合JSR-380校验分组的具体实现：

首先定义两个校验分组接口：

// 标记全量更新的校验分组
public interface FullUpdateGroup {}
// 标记部分更新的校验分组
public interface PartialUpdateGroup {}

然后在MyBean中给字段指定校验分组：

public class MyBean {
    // 无论PUT还是PATCH，ID都必须传入
    @NotNull(groups = {FullUpdateGroup.class, PartialUpdateGroup.class})
    private Long id;

    // 只有PUT时要求非空
    @NotNull(groups = FullUpdateGroup.class)
    private String field1;

    @NotNull(groups = FullUpdateGroup.class)
    private String field2;

    @NotNull(groups = FullUpdateGroup.class)
    private String field3;

    // getter、setter省略
}

最后控制器中分别使用不同分组校验：

@RestController
@RequestMapping("/test")
public class TestController {

    @Autowired
    private MyBeanMapper myBeanMapper;

    @PutMapping
    public void fullUpdate(@Validated(FullUpdateGroup.class) @RequestBody MyBean myBean) {
        myBeanMapper.updateMyBean(myBean);
    }

    @PatchMapping
    public void partialUpdate(@Validated(PartialUpdateGroup.class) @RequestBody MyBean myBean) {
        myBeanMapper.updateMyBean(myBean);
    }
}

这样就通过校验分组明确区分了PUT和PATCH的参数要求，完全符合各自的语义。

4. 可以用Map作为参数实现PATCH请求吗？ #

不推荐。正如你所说，用Map会带来两个核心问题：

• 无法使用JSR-380的Bean校验，只能手动判断字段合法性，代码冗余且易出错；
• Swagger等API文档工具无法自动识别Map中的字段，导致接口文档不清晰，客户端对接困难。

更好的替代方案是：

• 复用原MyBean配合校验分组（如上面的示例）；
• 或者创建专门的PartialMyBeanDTO，只包含ID和允许修改的字段，这样更轻量化，也方便文档生成。

5. 需要将MyBean的指定字段作为单独参数吗？ #

完全不需要。这种方式会导致控制器方法参数爆炸，维护成本极高，而且完全不符合RESTful接口的设计规范。用Bean/DTO配合校验分组是最优雅的解决方案。

总结 #

PUT和PATCH的区别体现在两个层面：

1. 语义层面：PUT是全量替换资源，PATCH是部分修改资源；
2. 代码实现层面：PUT需要做全量字段校验，确保客户端传入完整资源；PATCH只需要校验必要字段和传入字段的合法性。

而底层的MyBatis更新逻辑可以复用，因为你已经写好了动态更新的语句，完美适配两种场景。

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