Java中equals与hashCode应避免直接使用float/double字段，须转为确定性表示：equals用Math.abs(a-b)<epsilon误差比较或BigDecimal；hashCode用Double.doubleToLongBits()标准化或改用BigDecimal。

Java 中 equals 与 hashCode 避免浮点数精度陷阱，核心在于：不直接用 float/double 字段参与 equals 判断和 hashCode 计算，而是统一转为确定性表示后再处理。

equals 方法里别直接比较浮点字段

浮点数的 == 或 Double.equals() 会严格比对二进制值，0.1 + 0.2 ≠ 0.3。若业务上认为“数值接近即相等”，就不能依赖默认行为。

• 用 Math.abs(a - b) < epsilon 替代 a == b，epsilon 通常取 1e-6（单精度）或 1e-10（双精度）
• 对包装类如 Double，先判 null，再转基本类型比较，避免自动拆箱引发 NullPointerException
• 若业务允许误差，重写 equals 时所有浮点字段都走误差比较；若必须精确相等（如金融场景），应改用 BigDecimal 存储和比较

hashCode 不要用原始浮点值计算

Objects.hash(x, y) 若传入 double 类型字段，底层调用的是 Double.hashCode() —— 它把 double 转成 long 再哈希，但 +0.0 和 -0.0 的 hashCode 不同，且 0.1+0.2 这类计算结果的哈希值不稳定。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 推荐将浮点字段先标准化：用 Double.doubleToLongBits(value) 转为 long，再参与 hash
• 或统一转为字符串再哈希（如 String.valueOf(value)），但注意 0.0 和 -0.0 的 toString 结果不同，需提前 normalize
• 更稳妥做法是避免用浮点字段作为 equals/hashCode 的关键依据；如非用不可，优先用 BigDecimal，并重写其 equals/hashCode（它本身已正确实现）

典型错误写法与修正示例

假设 Person 类含 double salary 字段：

立即学习“Java免费学习笔记（深入）”；

• ❌ 错误：直接 Objects.equals(salary, other.salary) + Objects.hash(name, salary)
• ✅ 正确：在 equals 中用 Math.abs(salary - other.salary) < 1e-10；在 hashCode 中用 Double.doubleToLongBits(salary)
• ✅ 更优：salary 改为 BigDecimal，构造时用 new BigDecimal("5000.5")，后续直接调用其 equals/hashCode

工具类和 IDE 的辅助边界

Objects.equals() 和 Objects.hash() 很方便，但它们不解决浮点语义问题 —— 它们只是帮你少写 null 判断和组合逻辑，不会自动做误差容忍或位标准化。

• IDE 自动生成的 equals/hashCode 默认按字段直连，对 double/float 仍会出错，务必手动检查并替换
• Lombok 的 @EqualsAndHashCode 默认包含所有非 static/non transient 字段，若含浮点类型，需显式 exclude 或用 @EqualsAndHashCode(onlyExplicitlyIncluded = true) 精确控制
• 测试时一定要覆盖边界值：+0.0、-0.0、NaN、无穷大，这些在 equals 和 hashCode 中行为特殊