Java REST API如何结合Hibernate Validator实现PATCH方法支持？

在Java中编写REST API时，PATCH方法要求将请求实体中的“变更集”应用到请求URI标识的资源。

示例场景 #

给定原始资源：

{
  "productId": 7,
  "name": "container",
  "contactPerson": "peter",
  "price": 12
}

通过PATCH请求需要实现仅将contactPerson字段设为NULL，且不修改其他字段，示例请求体如下：

{
  "productId": 7,
  "contactPerson": null
}

技术栈要求 #

需结合Java生态的以下核心库实现，确保全面支持：

• Jackson（JSON反序列化）
• Hibernate Validator（Bean验证）
• MicroProfile OpenAPI（API定义）

已尝试的方案及问题 #

使用Java Optional的局限性 #

起初尝试用Optional实现，但发现它并不适配PATCH场景：

• Optional设计初衷并非存储NULL值，但PATCH需要支持显式将字段设为NULL（区别于省略字段）。
• Hibernate Validator对泛型内的注解支持不符合预期，例如：

@Schema(required = false, nullable = false)
Optional<@NotNull @Size(max = 255) String> name = Optional.empty();

当请求中省略name字段时，Hibernate Validator会判定违反@NotNull注解，这不符合需求——注解应该仅在字段被显式传入时生效，而非作用于Optional本身。

使用Jackson JsonNullable的问题 #

Jackson提供的JsonNullable注解是适配PATCH场景的合适工具，且支持OpenAPI，但目前未发现Hibernate Validator对其提供原生支持。

核心验证需求 #

使用@Size、@Email等Bean Validation注解时，需满足：

• 当PATCH请求中包含/设置字段时，Hibernate Validator执行对应验证；
• 当PATCH请求中省略字段时，不执行对应验证。

提问 #

Java生态中的这些主流库是否支持REST PATCH？若支持，推荐的实现方式是什么？

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