关于java.util.Objects.checkIndex方法@ForceInline注解的疑问及咨询

环境信息 #

Java版本: openjdk-18.0.2.1

相关代码：

@ForceInline
public static int checkIndex(int index, int length) {
    return Preconditions.checkIndex(index, length, null);
}

疑问点 #

• 不清楚java.util.Objects类的checkIndex方法（Java9版本新增）为何需要添加@ForceInline注解，初步认为这可能是HotSpot VM的剖析与内联机制完善前的临时解决方案，该观点是否正确？
• 同类方法checkFromToIndex和checkFromIndexSize是否未添加该注解？

问题解答 #

1. @ForceInline注解的作用与观点验证

你的观点方向正确，但更准确的定位是：这是JDK团队针对高频调用的轻量化边界检查方法做的性能保障手段，而非单纯的临时方案。

checkIndex这类方法是集合、数组操作的基础校验逻辑，会被大量代码调用。HotSpot的常规内联策略依赖调用频率、方法大小等启发式规则，若不强制内联，可能会因调用链层级、内联阈值限制等因素，导致该方法无法被内联，产生额外的栈帧调用开销——这类微小开销累积后会影响整体性能。

通过@ForceInline（JDK内部的jdk.internal.vm.annotation.ForceInline），可以强制JVM跳过常规判断直接内联该方法，确保性能最优。随着HotSpot内联机制的完善，这类注解的必要性确实会降低，但目前JDK核心工具类中仍会对这类高频小方法保留该注解。

2. 同类方法的注解情况

在JDK 18及后续多个版本中，checkFromToIndex和checkFromIndexSize同样添加了@ForceInline注解，它们的实现逻辑与checkIndex一致，都是转发调用到Preconditions的对应方法，因此同样通过强制内联来保证性能。

示例代码（checkFromToIndex）：

@ForceInline
public static int checkFromToIndex(int fromIndex, int toIndex, int length) {
    return Preconditions.checkFromToIndex(fromIndex, toIndex, length, null);
}

内容的提问来源于stack exchange，提问作者YoungJun Park