GraalVM Native Image构建后运行报错，IDE（Java17）中正常

你遇到的错误是GraalVM Native Image构建后，Netty的DNS解析组件无法正确加载系统DNS配置导致的NullPointerException。在JVM模式下，JDK可以动态访问sun.net.dns.ResolverConfigurationImpl等类并读取系统资源，但Native Image是提前编译的，这些类和资源访问需要显式配置才能被正确包含到镜像中。

1. 添加Native Image元数据配置 #

在项目的src/main/resources/META-INF/native-image目录下创建以下配置文件，显式声明需要反射访问的类和需要读取的资源：

reflect-config.json #

[
  {
    "name": "sun.net.dns.ResolverConfigurationImpl",
    "allDeclaredConstructors": true,
    "allDeclaredMethods": true,
    "allDeclaredFields": true
  },
  {
    "name": "com.sun.jndi.dns.DnsContextFactory",
    "allDeclaredConstructors": true,
    "allDeclaredMethods": true
  },
  {
    "name": "javax.naming.directory.InitialDirContext",
    "allDeclaredConstructors": true
  }
]

resource-config.json #

{
  "resources": [
    {"pattern": "\\/etc\\/resolv.conf$"},
    {"pattern": "\\/system\\/private\\/etc\\/resolv.conf$"}
  ]
}

这些配置让Native Image包含DNS配置文件的访问权限，以及相关类的反射能力。

2. 显式配置Netty DNS解析器 #

绕过默认的系统DNS配置加载逻辑，直接在HttpClient中指定DNS服务器或使用Netty的默认解析器：

修改你的HttpCommands类中的HttpClient初始化代码：

import reactor.netty.http.client.HttpClient;
import io.netty.resolver.dns.DefaultDnsServerAddressStreamProvider;

// 在创建HttpClient时指定解析器
HttpClient httpClient = HttpClient.create()
    .resolver(spec -> spec.dnsServerAddressStreamProvider(DefaultDnsServerAddressStreamProvider.INSTANCE));

或者直接指定固定的公共DNS服务器（比如Google DNS）：

import reactor.netty.http.client.HttpClient;
import io.netty.resolver.dns.DnsNameResolverBuilder;
import io.netty.resolver.dns.DnsServerAddresses;
import java.net.InetAddress;

HttpClient httpClient = HttpClient.create()
    .resolver(spec -> spec.nameResolverGroup(
        new DnsNameResolverBuilder()
            .nameServerProvider(addressStream -> 
                DnsServerAddresses.sequential(
                    InetAddress.getByName("8.8.8.8"),
                    InetAddress.getByName("8.8.4.4")
                )
            )
            .build()
    ));

3. 确保Spring Boot Native插件配置正确 #

在pom.xml中添加Spring Boot Maven插件的Native镜像构建配置，确保使用兼容的构建器：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${spring-boot.version}</version> <!-- 确保是3.x及以上版本 -->
            <configuration>
                <image>
                    <builder>paketobuildpacks/builder-jammy-base:latest</builder>
                    <env>
                        <BP_NATIVE_IMAGE>true</BP_NATIVE_IMAGE>
                        <BP_NATIVE_IMAGE_BUILD_ARGUMENTS>
                            --enable-all-security-services
                        </BP_NATIVE_IMAGE_BUILD_ARGUMENTS>
                    </env>
                </image>
            </configuration>
        </plugin>
    </plugins>
</build>

--enable-all-security-services参数会启用Native Image中所有安全相关的服务，包括DNS解析需要的JNDI服务。

1. 重新构建Native Image：mvn spring-boot:build-image
2. 运行生成的镜像，执行GET命令测试功能是否正常。

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