构建GraalVM Native Image时如何排除未使用的指定类？

1. 直接用--exclude-classes参数排除目标类 #

在你的native-image构建命令中添加以下参数，明确告诉GraalVM不要处理这两个未使用的类：

--exclude-classes me.chanjar.weixin.common.util.http.jodd.JoddHttpSimplePostRequestExecutor,me.chanjar.weixin.common.util.http.okhttp.OkHttpSimplePostRequestExecutor

这个参数会让GraalVM完全忽略指定类，不会尝试解析它们的依赖，直接绕过因缺失Jodd/OkHttp依赖导致的错误。

2. 通过反射配置文件排除类 #

在项目的META-INF/native-image目录下创建reflect-config.json文件，写入如下内容：

[
  {
    "name": "me.chanjar.weixin.common.util.http.jodd.JoddHttpSimplePostRequestExecutor",
    "exclude": true
  },
  {
    "name": "me.chanjar.weixin.common.util.http.okhttp.OkHttpSimplePostRequestExecutor",
    "exclude": true
  }
]

对于Quarkus项目，这个配置文件会被自动加载；其他项目需要确保构建时该文件被包含到classpath中。

3. 封装工厂类规避未使用分支（根源解决） #

如果无法修改第三方库的代码，在自己的业务代码中封装一层工厂，只保留Apache的实现：

public class CustomRequestExecutorFactory {
    public static RequestExecutor<String, String> create(RequestHttp requestHttp) {
        // 强制使用Apache实现，跳过其他分支
        return new ApacheSimplePostRequestExecutor(requestHttp);
    }
}

后续业务代码直接调用这个自定义工厂，GraalVM的静态分析就不会触及另外两个未使用的类，彻底避免依赖解析问题。

4. 调整类初始化时机（备选方案） #

如果全局启用了--link-at-build-time，可以对目标类设置延迟初始化：
在native-image命令中添加：

--delay-class-initialization-to-runtime=me.chanjar.weixin.common.util.http.jodd.JoddHttpSimplePostRequestExecutor,me.chanjar.weixin.common.util.http.okhttp.OkHttpSimplePostRequestExecutor

注意：这个方法仅当GraalVM不会在构建时强制解析类结构时有效，如果仍触发依赖检查，还是会报错，因此优先级低于前两种方案。

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