真正简化非空校验的关键在于减少重复、提升可读性、避免硬编码异常信息,而非单纯缩短代码:静态导入实现notNull()调用;封装工具类自动拼接提示;Lombok或AOP实现零侵入校验;新项目优先采用@Valid声明式校验。

Spring 的 Assert.notNull 本身已经很简洁,但要“进一步简化”非空校验并统一异常处理,关键不在于缩短单行代码,而在于减少重复、提升可读性、避免硬编码异常信息。下面几种方式能真正让校验更轻量、更可控:
用静态导入 + 单行断言
这是最直接的简化——省去类名前缀,让校验语句像内置语法一样干净:
import static org.springframework.util.Assert.notNull;
public void updateUser(Long id, String name) {
notNull(id, "id must not be null");
notNull(name, "name must not be null");
// ...
}
- 无需写
Assert.notNull(...),直接notNull(...) - 适合少量参数、快速验证场景
- 异常类型固定为
IllegalArgumentException,消息需手动传入
封装通用校验工具方法
当项目中大量出现类似校验逻辑时,可封装一层,把“非空+提示”绑定成语义化方法:
public class Check {
public static <T> T notNull(T object, String field) {
notNull(object, () -> field + " must not be null");
return object;
}
}
// 使用
public void createUser(String email, Integer age) {
Check.notNull(email, "email");
Check.notNull(age, "age");
}
- 字段名自动拼接提示,减少字符串硬编码
- 支持链式调用(返回原对象,可嵌入表达式)
- 后续还可扩展如
notBlank、positive等方法
结合 Lombok + 自定义注解(编译期/运行期)
如果追求零手写校验代码,可用 Lombok 的 @NonNull(编译期插入 null 检查),或配合 Spring AOP + 自定义注解实现运行期统一拦截:
立即学习“Java免费学习笔记(深入)”;
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface NotNullParam {
String value() default "";
}
// AOP 切面自动校验标注参数
@Around("@annotation(notNullParam)")
public Object checkNotNull(ProceedingJoinPoint joinPoint, NotNullParam notNullParam) {
Object[] args = joinPoint.getArgs();
// 扫描参数,对标注且为 null 的抛异常
// ...
}
- 方法签名即契约,调用方一目了然哪些参数不可为空
- AOP 方式彻底解耦校验逻辑,业务方法体里不再出现
notNull - 注意:AOP 不适用于 private 方法或内部调用(绕过代理)
升级到 Jakarta EE / Bean Validation(推荐新项目)
对于 Web 层或 DTO 入参,优先使用标准规范而非 Spring Assert:
public record UserRequest(
@NotBlank(message = "username is required")
String username,
@NotNull(message = "age is required")
Integer age
) {}
// Controller 中直接启用校验
@PostMapping
public ResponseEntity<?> create(@Valid @RequestBody UserRequest req) { ... }
- 声明式校验,和框架深度集成(自动绑定错误、国际化支持)
- 支持组合注解、分组校验、自定义约束等高级能力
- Assert.notNull 更适合 Service 层内部逻辑校验,而非入口参数
不复杂但容易忽略:真正的简化不是少敲几个字符,而是让校验意图清晰、位置合理、维护成本低。选哪种方式,取决于你的校验场景——入口参数用 @Valid,内部逻辑用 notNull 静态导入,高频复用就封装工具类。


















