为Collections.EmptyList注册RuntimeHints无效问题排查

问题根源 #

异常核心在于：GraalVM Native Image环境中，Spring EL表达式反射调用java.util.Collections$EmptyList.size()时，Java模块系统限制java.base未将java.util包开放给未命名模块，导致反射访问失败；同时原RuntimeHints配置未完全覆盖所需反射权限。

方案一：修改SpEL表达式（推荐，最简洁） #

直接替换unless表达式中的size()==0为无需反射调用的判断逻辑，规避模块权限问题：

方式1：使用List接口的isEmpty()方法 #

@Cacheable(value = "autosuggest", key = "#term", unless = "#result.isEmpty()")
@Override
public List<AutoSuggestUser> autoSuggestUsers(String term) {
    if (term.length() <= 3)
        return Collections.emptyList();
    // ... 业务逻辑
}

方式2：直接判断是否为EmptyList实例 #

@Cacheable(value = "autosuggest", key = "#term", unless = "#result == T(java.util.Collections).emptyList()")
@Override
public List<AutoSuggestUser> autoSuggestUsers(String term) {
    if (term.length() <= 3)
        return Collections.emptyList();
    // ... 业务逻辑
}

方案二：配置Native Image模块权限+修正RuntimeHints（保留原表达式时使用） #

若必须保留原size()==0表达式，需同时处理模块权限和反射配置：

1. 开放Java模块访问权限 #

在Native Image构建过程中添加参数，允许未命名模块访问java.util包：

• Maven构建：在spring-boot-maven-plugin中添加构建参数

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <image>
            <env>
                <BP_NATIVE_IMAGE_BUILD_ARGUMENTS>--add-opens java.base/java.util=ALL-UNNAMED</BP_NATIVE_IMAGE_BUILD_ARGUMENTS>
            </env>
        </image>
    </configuration>
</plugin>

• 直接使用native-image命令：

native-image --add-opens java.base/java.util=ALL-UNNAMED -jar your-application.jar

2. 修正RuntimeHints配置 #

原配置仅注册INVOKE_DECLARED_METHODS，需补充public方法调用权限，或直接指定size()方法：

方式1：添加public方法权限

static class MyRuntimeHints implements RuntimeHintsRegistrar {
    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        hints.reflection().registerType(TypeReference.of("java.util.Collections$EmptyList"),
                builder -> builder.withMembers(
                    MemberCategory.INVOKE_PUBLIC_METHODS,
                    MemberCategory.INVOKE_DECLARED_METHODS
                ));
    }
}

方式2：直接注册size()方法

static class MyRuntimeHints implements RuntimeHintsRegistrar {
    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        try {
            Class<?> emptyListClass = Class.forName("java.util.Collections$EmptyList");
            Method sizeMethod = emptyListClass.getMethod("size");
            hints.reflection().registerMethod(sizeMethod);
        } catch (ClassNotFoundException | NoSuchMethodException e) {
            throw new RuntimeException("Failed to register EmptyList.size() for reflection", e);
        }
    }
}

方案三：临时替代方案（不推荐） #

将返回的Collections.emptyList()替换为普通空ArrayList，避免使用受模块权限限制的EmptyList：

if (term.length() <= 3)
    return new ArrayList<>(); // 替换原Collections.emptyList()

此方式会额外创建对象，影响性能，仅作为临时 workaround 使用。

内容的提问来源于stack exchange，提问作者Ladu anand