企业官网建设流程全解析

一、 背景：标准注解不够用了怎么办？

在 Spring Boot 开发中，我们习惯了使用@NotNull,@Size,@Pattern来校验参数。但是，业务往往比这复杂得多。

场景举例：
我们有一个用户保存接口（UserSaveReqVO），既用于新增，也用于修改。

1. 新增时：id为空，但password必须填。
2. 修改时：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这种方法级校验时，有两个细节必须注意：

1. 方法名必须以is或get开头：
   校验器是按照 JavaBean 规范来找方法的。建议使用isValid()或isXxxValid()。
2. 必须加上@JsonIgnore：
   这是最容易踩的坑。如果不加，Jackson 序列化时会把这个方法当成一个属性（比如passwordValid: true）返回给前端，或者导致 Swagger 文档里多出莫名其妙的字段。

六、 总结

• 简单校验（非空、长度、正则）：直接用@NotNull,@Size等标准注解。
• 场景区分（新增/修改）或跨字段逻辑（A有值则B必填）：优先推荐使用@AssertTrue+ 自定义方法。

它让你的代码更内聚、更易读，并且避免了 Controller 层繁琐的分组配置。