深入理解 Java 包装类缓存机制：从 Integer 比较失效谈起

本文档记录了在业务开发中遇到的 Integer 类型比较导致数据丢失的问题，深入分析了 == 与 equals() 的区别及 Integer 缓存机制。

1. 问题复现

在菜单数据筛选的业务逻辑中，使用 Integer 类型的 menuId 进行比较时出现异常现象：

• 方式 A：integer.equals(menuDO.getMenuId()) -> 数据完整，逻辑正常。
• 方式 B：integer == menuDO.getMenuId() -> 数据丢失，部分匹配失败。

核心原因总结：

[!warning] 核心原因
== 比较的是对象的内存地址，而 equals()比较的是对象的实际数值。
当 Integer 数值超出 -128 ~ 127 的缓存范围时，== 会因为对象地址不同而返回 false，导致数据被错误过滤。

2. 核心概念解析

要理解这个问题，需要明确 Java 中包装类的两个关键机制。

2.1 包装类 vs 基本类型

• int (基本类型)：直接存储数值，使用 == 比较时，直接比较数值大小，永远不会出错。
• Integer (包装类)：本质是对象。
  • 使用 == 比较时，比较的是两个对象的内存地址是否相同。
  • 使用 equals() 比较时，比较的是两个对象封装的数值是否相同（Integer 重写了 equals 方法）。

2.2 Integer 的缓存机制 (The Trap)

Java 为了优化性能，对小数值进行了缓存（Flyweight Pattern 享元模式）。

• 缓存范围：默认是 -128 ~ 127。
• 命中缓存：当数值在此范围内，Integer.valueOf() 会直接返回缓存中的同一个对象引用。此时 == 比较地址会返回 true。
• 未命中缓存：当数值超出此范围，每次都会 new 一个新的 Integer 对象。此时两个对象的内存地址不同，== 比较会返回 false。

3. 场景还原与分析

结合上述机制，分析为何菜单数据会丢失：

1. 场景一：ID 在 -128 ~ 127 之间

   • integer 和 menuDO.getMenuId() 指向缓存池中的同一个对象。
   • == 判定地址相同，返回 true。
   • 结果：数据匹配成功，未丢失。

2. 场景二：ID 超出 -128 ~ 127 (如 ID = 128)

   • JVM 为两者分别创建了不同的对象，内存地址不同。
   • == 判定地址不同，返回 false。
   • 结果：虽然数值都是 128，但被误判为不相等，导致该条菜单数据被过滤（丢失）。

3. 为什么 equals() 没问题？

   • Integer.equals() 的逻辑是：先判断类型是否一致，再拆箱比较内部的 int 数值。
   • 无论是否在缓存范围内，它只关心数值是否相等。

4. 代码验证

以下代码直观展示了缓存机制带来的“坑”。

public class IntegerTest {
    public static void main(String[] args) {
        // 1. 测试缓存范围内的数据 (-128 ~ 127)
        Integer a = 127; 
        Integer b = 127;
        
        // 因为命中了缓存，a 和 b 指向同一个内存地址
        System.out.println("127 == 127: " + (a == b));       // 输出: true
        System.out.println("127 equals 127: " + a.equals(b)); // 输出: true

        System.out.println("-------------------");

        // 2. 测试缓存范围外的数据
        Integer c = 128; 
        Integer d = 128;
        
        // 超出缓存范围，JVM 创建了两个不同的对象，内存地址不同
        System.out.println("128 == 128: " + (c == d));       // 输出: false (坑点所在！)
        System.out.println("128 equals 128: " + c.equals(d)); // 输出: true
    }
}

5. 总结与规范

为了避免此类隐蔽的 Bug，在开发中应遵循以下规范：

1. 对象比较用 equals：凡是包装类（Integer, Long, Boolean 等）的比较，严禁使用 ==，必须使用 equals()。
2. 防空指针：在使用 equals() 前，建议进行非空判断或使用常量前置。
   • 推荐写法：integer != null && integer.equals(menuDO.getMenuId())
   • 或者使用工具类：Objects.equals(a, b) (推荐，自动处理 null)
3. 基本类型用 ==：如果是 int 基本类型，继续使用 == 即可。