记录类本身不支持运行时校验，需显式构造器或Jakarta Bean Validation框架配合使用；推荐用私有构造器+静态工厂方法实现创建时强制校验。
java 记录类（record）本身是不可变且无自定义逻辑的，**不能直接在字段声明时执行运行时校验**。它不支持构造器中插入校验逻辑（除非显式定义全参构造器并手动校验），也不支持注解驱动的自动校验（如 @notnull）——这些注解需配合验证框架（如 jakarta bean validation）和显式调用才能生效。
记录类本身不触发校验，必须搭配验证框架使用
记录类生成的隐式构造器不会自动检查参数合法性。例如：
record User(String name, int age) {}
User u = new User("", -5); // 合法编译，但业务上非法
要实现字段校验，需引入 Jakarta Bean Validation（如 Hibernate Validator），并对字段添加约束注解：
- 添加依赖（Maven）：
<dependency> <groupId>org.hibernate.validator</groupId> <artifactId>hibernate-validator</artifactId> <version>8.0.1.Final</version> </dependency>
- 在 record 字段上标注约束（Java 14+ 支持）：
record User( @NotBlank(message = "姓名不能为空") @Size(max = 20, message = "姓名长度不能超过20") String name, @Min(value = 0, message = "年龄不能为负数") @Max(value = 150, message = "年龄不能超过150") int age) {} - 手动触发校验（通常在入口层，如 Controller 或 Service）：
Validator validator = Validation.buildDefaultValidatorFactory().getValidator(); Set<ConstraintViolation<User>> violations = validator.validate(new User("", -1)); if (!violations.isEmpty()) { violations.forEach(v -> System.out.println(v.getMessage())); }
推荐：用显式构造器封装校验逻辑（更可控、无依赖）
若想避免框架依赖、确保每次创建都强制校验，可放弃隐式构造器，**显式定义私有全参构造器 + 公共静态工厂方法**：
record User(String name, int age) {
public User {
if (name == null || name.trim().isEmpty()) {
throw new IllegalArgumentException("姓名不能为空");
}
if (name.length() > 20) {
throw new IllegalArgumentException("姓名长度不能超过20");
}
if (age < 0 || age > 150) {
throw new IllegalArgumentException("年龄必须在 0~150 之间");
}
}
public static User of(String name, int age) {
return new User(name, age);
}
}
这样任何通过 User.of(...) 创建实例的行为都会立即校验，且无法绕过（因私有构造器禁止外部直接调用 new User(...)）。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
与 Spring Boot 集成时的注意事项
Spring 默认不支持对 record 的 @Valid 参数自动校验（Spring Boot 3.1+ 已初步支持，但仍需配置）：
- 确保启用验证：在 controller 方法参数前加
@Valid，并开启@Validated（类级别） - Spring MVC 需注册
MethodValidationPostProcessor（若使用 AOP 校验） - 更稳妥的做法：在 service 层统一调用
validator.validate()，而非依赖 controller 自动绑定校验
关键提醒：校验时机决定可靠性
数据校验不是“写个注解就完事”，必须明确校验发生在哪一环：
- ✅ 构造时校验（显式构造器）→ 最早、最可靠，杜绝非法对象诞生
- ✅ 入口层（API 接收后）校验 → 适合 Web 场景，配合错误响应统一处理
- ❌ 仅靠注解 + 无调用 → 校验永远不会执行
- ❌ 在 record 内部用 getter 校验 → 违反不可变设计，且 getter 不该有副作用
