@notnull对基本类型无效,因int等不能为null;校验数值范围应改用integer+@notnull+@min或int+@min;validate()返回set需手动检查,spring推荐@valid参数校验;自定义message需配validationmessages.properties;嵌套对象须加@valid。

为什么 @NotNull 对基本类型字段没用
Java 基本类型(如 int、boolean)永远不可能为 null,所以 @NotNull 加在它们身上完全不生效——验证器直接跳过,连报错都不会报。这是新手最常踩的坑,以为加了注解就万事大吉。
实际场景里,比如你有个 userId 字段定义成 int userId,又想约束它“不能是 0 或负数”,那就得换思路:
- 改用包装类型
Integer userId,再配合@NotNull+@Min(1) - 或者保留
int,只用@Min(1)(注意:它校验的是值,不是空) -
@Min和@Max对基本类型有效,但对null值会跳过——所以如果字段允许为空,又需要数值范围,必须组合使用@Null/@NotNull和@Min
如何让 validate() 抛出具体错误而不是静默失败
调用 validator.validate(object) 返回的是 Set<constraintviolation>></constraintviolation>,不是异常。很多人写了注解却没看到报错,就是因为没检查返回值,更没处理它。
常见错误现象:对象明显违反 @Size(min=2),但程序照常往下走,日志也没提示。
立即学习“Java免费学习笔记(深入)”;
- 必须显式判断
if (!violations.isEmpty()),然后遍历violations取.getMessage()或.getPropertyPath() - Spring 环境下推荐用
@Valid+ 方法参数校验,由框架自动抛MethodArgumentNotValidException,比手写validate()更可靠 - 别在实体类构造函数里调用
validate()——此时字段可能还没赋值,校验结果无意义
自定义注解里 message 属性为何总显示默认值
自定义注解如 @MyEmail(message = "邮箱格式不对"),运行时却还是输出 “must be a well-formed email address”,说明资源绑定没生效。
根本原因是:Hibernate Validator 默认只加载类路径下的 ValidationMessages.properties,且要求 key 必须严格匹配注解的 message 值(包括花括号)。
- 如果你的注解用了
message = "{my.email.invalid}",就必须在ValidationMessages.properties里配my.email.invalid=邮箱格式不对 - 不要试图在
message里写中文字符串直传——它会被当 key 查找,找不到就回落到默认消息 - Spring Boot 项目中,确保该 properties 文件在
src/main/resources/下,且文件名拼写准确(大小写敏感)
嵌套对象校验失效?记得加 @Valid
父对象字段是另一个 Bean 类型时,比如 User 里有 Address address,即使 Address 类里写了 @NotBlank,默认也不会触发它的校验。
这是因为 Hibernate Validator 默认只做浅层校验,嵌套对象需显式声明“请继续往下验”:
- 在
address字段上加@Valid注解(注意不是@Validation或其他变体) -
@Valid是 JSR 380 标准注解,属于javax.validation包,别导错成 Spring 的同名类 - 集合类字段如
List<address></address>同样需要@Valid,它会对每个元素单独校验 - 若嵌套对象字段为
null,@Valid会跳过,不会报错——这是设计行为,不是 bug
复杂点在于级联深度和循环引用:一旦 A 引用 B,B 又引用回 A,@Valid 可能导致无限递归或 StackOverflowError,这种时候得手动控制验证路径,而不是全靠注解堆砌。










