注解本身不能防止类型溢出，但结合@Min/@Max或自定义@InIntRange等约束注解，在参数绑定或配置加载时可前置拦截超界值；需使用包装类、启用@Validated，并明确基本类型硬性取值范围。
直接用注解语法本身无法防止类型溢出，因为注解只是元数据，不参与运行时数值计算或边界校验。但可以结合注解驱动的校验机制（如 @Min、@Max、自定义约束注解），在参数绑定阶段就拦截超出基本类型安全边界的值。
明确基本类型的合法取值范围
Java 基本整数类型有固定上下界，这是所有防护的前提：
-
int：-2147483648 到 2147483647（即
Integer.MIN_VALUE~Integer.MAX_VALUE） - short：-32768 到 32767
- byte：-128 到 127
- long：-9223372036854775808 到 9223372036854775807
这些不是“建议值”，而是 JVM 层面的硬性限制；超范围字符串转为基本类型时会抛异常或静默截断，必须前置拦截。
用 JSR-303 标准注解限定包装类参数
@Min 和 @Max 对原始类型（如 int）无效，只对包装类（Integer、Long 等）生效，且需配合 @Validated 或 @Valid 触发校验：
- Controller 方法参数改用
Integer而非int - 加上
@Min(Integer.MIN_VALUE) @Max(Integer.MAX_VALUE) - 类上或方法上标注
@Validated，Spring 才会执行校验逻辑
示例：
public String handleOrder(@RequestParam @Min(-2147483648) @Max(2147483647) Integer orderId) { ... }自定义注解实现类型安全边界校验
标准注解无法表达“必须落在某基本类型范围内”这种语义，可自定义注解 + ConstraintValidator 实现复用：
- 定义注解
@InIntRange，支持对Integer、Long、Short字段统一校验 - 实现
ConstraintValidator<InIntRange, Number>，内部调用Number.longValue()后比对预设边界 - 注解加在
@ConfigurationProperties类字段上，或 Controller 参数上
这样一处定义，多处使用，避免每个参数重复写 @Min/@Max 数值字面量。
配合配置类与外部化校验提升安全性
对 @ConfigurationProperties 绑定的配置项，更要严防溢出 —— 配置错误可能影响全局行为：
- 配置类字段声明为
Integer，而非int - 字段上添加
@InIntRange或@Min/@Max - 类上加
@Validated，确保启动时就校验配置合法性 - 若校验失败，Spring Boot 会直接启动报错，避免带错配置上线
比如数据库连接池的 max-active 配置，若被误设为 9999999999，虽能解析成 long，但转 int 时溢出，导致实际值变成负数，引发连接池异常。
