在定义Java接口参数时，遇到整数类型，到底该用int还是Integer？

在Java接口参数定义中选择int（基本类型）还是Integer（包装类型），核心取决于业务场景、空值处理、框架/工具依赖三大维度，以下是系统性的分析和决策指南：

一、核心差异：先理清基础区别

维度	int（基本类型）	Integer（包装类型）
空值支持	不支持，默认值0	支持，可赋值null
内存/性能	栈存储，无装箱拆箱开销	堆存储，自动装箱/拆箱有轻微开销
集合/泛型	不支持（泛型只能用引用类型）	支持（如List）
序列化	直接序列化值	序列化对象（兼容值）
方法/特性	无额外方法	提供parseInt、compare等工具方法

二、决策核心原则

1. 优先用int的场景（简单值传递，无空值需求）

如果参数是必传、非空的整数 ，且不需要空值语义，优先用int：

• 纯业务计算场景（如：int add(int a, int b)）；
• 性能敏感的高频调用接口（避免装箱拆箱开销）；
• 明确不允许空值的参数（如：用户ID、数量、年龄等必须有值的字段）；
• 与底层系统交互（如JNI、数组操作），基本类型更适配。

示例：

// 计算两数之和，参数必传且非空，用int
public interface Calculator {
    int sum(int num1, int num2);
}

// 获取用户年龄，年龄不可能为null，用int
public interface UserService {
    void updateAge(Long userId, int age);
}

2. 必须用Integer的场景（需要空值/泛型/框架兼容）

以下场景只能或建议用Integer：

• 需要表达空值语义 ：参数可选传（如：Integer min表示"无最小值限制时传null"）；
• 泛型/集合场景 ：接口参数包含泛型（如List<Integer>、Map<String, Integer>）；
• 框架/工具依赖 ：
  • Spring/MyBatis等框架：数据库字段允许NULL时，需用Integer（否则0会被误判为有效值）；
  • JSON序列化：需区分"未传值（null）"和"传0"（如接口入参JSON中缺省字段 vs 显式传0）；
  • 反射/注解场景：如JPA实体字段、Swagger接口文档需标注可选参数；
• 包装类型特性依赖 ：需使用Integer的工具方法（如compare、valueOf）。

示例：

// 分页查询，size可选（传null表示用默认值），用Integer
public interface PageQuery {
    List<Order> query(Integer pageNum, Integer pageSize);
}

// 泛型接口，必须用Integer
public interface DataProcessor<T> {
    T process(List<Integer> data);
}

// 数据库字段允许NULL（如用户积分，未设置则为NULL）
public interface UserRepository {
    void updateScore(Long userId, Integer score);
}

三、避坑要点

1. 空指针风险 ：

   用Integer时必须做null校验，否则调用intValue()或参与运算会抛出NullPointerException：

   // 错误示例：未校验null
   public interface Demo {
       default int calculate(Integer num) {
           return num + 1; // num为null时NPE
       }
   }
   // 正确示例：增加null校验
   default int calculate(Integer num) {
       return Optional.ofNullable(num).orElse(0) + 1;
   }

2. 自动装箱/拆箱的坑：

   public interface Test {
       // 看似没问题，但num为null时会自动拆箱抛NPE
       void print(int num, Integer num2);
   }
   // 调用时：test.print(null, 1); // 编译报错（int不能接null）
   // 隐藏坑：test.print(num2, 1); // 若num2是null，拆箱时NPE

3. 默认值差异：

   • int未赋值时默认0（可能被误判为有效值）；
   • Integer未赋值时默认null（可明确区分"未设置"）。

四、总结建议

场景	推荐类型	理由
必传、非空的整数参数	int	性能好、无空指针风险
可选传、需表达"未设置"的参数	Integer	可区分null和0，语义清晰
泛型/集合/框架适配	Integer	符合Java类型规范
高频调用的性能敏感接口	int	避免装箱拆箱开销
数据库字段允许NULL的映射	Integer	适配NULL值

终极原则：

• 若参数"必须有值"，用int；
• 若参数"可选/需区分空值"，用Integer（但必须加null校验）；
• 团队内部统一规范比纠结类型更重要（如：所有接口参数统一用包装类型，避免混用混乱）。