一、 背景：标准注解不够用了怎么办？
在 Spring Boot 开发中，我们习惯了使用@NotNull,@Size,@Pattern来校验参数。但是，业务往往比这复杂得多。
场景举例：
我们有一个用户保存接口（UserSaveReqVO），既用于新增，也用于修改。
- 新增时：
id为空，但password必须填。 - 修改时：
id必填，但password可以为空（为空代表不修改密码）。
痛点：
如果直接在password字段上加@NotBlank，那么修改接口也会报错。如果不加，新增接口就不安全。怎么解决？
二、 什么是 @AssertTrue？
@AssertTrue是 Bean Validation (Hibernate Validator) 提供的一个标准注解。
- 字面含义：断言为真。
- 作用对象：通常用于Boolean 类型的字段或返回 Boolean 类型的方法。
- 校验规则：
- 如果值为
true，校验通过。 - 如果值为
false，校验失败，抛出异常并返回message中的错误信息。
- 如果值为
核心价值：它允许我们在 DTO 内部编写一段 Java 代码，来进行自定义的、跨字段的、带有业务逻辑的校验。
三、 实战示例：一行代码搞定“新增必填，修改选填”
我们不需要定义两个 DTO，也不需要搞复杂的 Group，直接在 VO 内部写一个方法即可。
importcom.fasterxml.jackson.annotation.JsonIgnore;importio.swagger.v3.oas.annotations.media.Schema;importlombok.Data;importjavax.validation.constraints.AssertTrue;importjava.util.Objects;@Data@Schema(description="用户保存请求 VO")publicclassUserSaveReqVO{@Schema(description="用户ID (新增为空，修改必填)")privateLongid;@Schema(description="账号")privateStringusername;@Schema(description="密码")privateStringpassword;// =================================================// 核心黑科技：自定义逻辑校验// =================================================@AssertTrue(message="新增用户时，密码不能为空")@JsonIgnore// ⚠️ 坑点预警：必须加这个，否则会多出一个名为 passwordValid 的字段返回给前端publicbooleanisPasswordValid(){// 逻辑拆解：// 1. 如果 id 不为空，说明是“修改模式”。// 修改模式下对密码没要求，直接返回 true (通过)。if(id!=null){returntrue;}// 2. 如果 id 为空，说明是“新增模式”。// 新增模式下，密码必须有值。returnpassword!=null&&!password.trim().isEmpty();}}Controller 使用方式：
完全不用改，照常加@Valid即可。
@PostMapping("/save")publicCommonResult<Boolean>saveUser(@Valid@RequestBodyUserSaveReqVOreqVO){// 如果校验失败，这里进不来，全局异常处理器会处理returnsuccess(userService.saveUser(reqVO));}四、 为什么它比 Validation Groups (分组校验) 更好？
很多教程会推荐使用groups属性来解决这个问题，但在实战工程中，@AssertTrue 往往更胜一筹。
1. 避免“注解地狱”与“类爆炸”
- Groups 方案：你需要定义
CreateGroup和UpdateGroup接口。然后字段上写@Null(groups=Create.class),@NotNull(groups=Update.class)… 代码看起来很乱。 - AssertTrue 方案：逻辑内聚在一个 Java 方法里，
if-else清晰易读。
2. 代码高内聚 (High Cohesion)
- Groups 方案：校验逻辑是割裂的。DTO 定义规则，Controller 决定触发哪个 Group。如果你在 Controller 里忘了写
@Validated(CreateGroup.class)，校验就失效了，容易出 Bug。 - AssertTrue 方案：校验逻辑完全封装在 DTO 内部。Controller 不需要关心是新增还是修改，只要加个
@Valid，DTO 自己会根据 ID 是否为空来判断该检查什么。
3. 解决“跨字段依赖”问题
这是 Group 做不到的。
- 需求：如果
type是 “手机注册”，则mobile必填；如果type是 “邮箱注册”，则email必填。 - AssertTrue：直接写个
if (type==1) return mobile != null;，轻松搞定。
五、 避坑指南
在使用@AssertTrue这种方法级校验时，有两个细节必须注意：
- 方法名必须以
is或get开头：
校验器是按照 JavaBean 规范来找方法的。建议使用isValid()或isXxxValid()。 - 必须加上
@JsonIgnore：
这是最容易踩的坑。如果不加，Jackson 序列化时会把这个方法当成一个属性（比如passwordValid: true）返回给前端，或者导致 Swagger 文档里多出莫名其妙的字段。
六、 总结
- 简单校验（非空、长度、正则）：直接用
@NotNull,@Size等标准注解。 - 场景区分（新增/修改）或跨字段逻辑（A有值则B必填）：优先推荐使用
@AssertTrue+ 自定义方法。
它让你的代码更内聚、更易读，并且避免了 Controller 层繁琐的分组配置。