配置com.sun.net.httpserver移除通配符绑定后API无法访问求排查

问题背景 #

在Kubernetes微服务中使用com.sun.net.httpserver.HttpServer暴露REST API，原本采用通配符绑定方式，现在需要改为绑定指定本地IP，但修改后API无法从Pod内部或外部访问。

原有代码（通配符绑定） #

之前的代码通过JdkHttpServerFactory创建服务，端口处于通配符绑定状态，允许任意方连接：

httpServer = JdkHttpServerFactory.createHttpServer("http://localhost:" + port + "/", resourceConfig, false); 
httpServer.start();

修改后的代码及问题 #

修改为绑定回环地址后，netstat显示绑定地址为[::ffff:127.0.0.1]:端口，但API无法访问：

InetAddress localHost = InetAddress.getLoopbackAddress();
InetSocketAddress sockAddr = new InetSocketAddress(localHost, port);
httpServer = com.sun.net.httpserver.HttpServer.create();
httpServer.bind(sockAddr,5);
httpServer.start();

补充尝试的代码及问题 #

尝试以下代码后，netstat显示为*绑定，但执行curl命令无响应，也没有404错误：

InetSocketAddress sockAddr = new InetSocketAddress(localHost, port);
httpServer = com.sun.net.httpserver.HttpServer.create();
httpServer.bind(sockAddr,5);
httpServer.start();

问题分析与解决 #

1. 绑定地址错误 #

绑定InetAddress.getLoopbackAddress()（即127.0.0.1）只能被Pod内的本地进程访问，Kubernetes中Pod的网络基于虚拟IP，外部请求（包括集群内其他Pod、外部客户端）无法通过回环地址访问服务。

解决方式：
绑定Pod的实际IP，Kubernetes会自动将Pod IP注入到环境变量POD_IP中，可通过以下代码获取并绑定：

// 从环境变量读取Pod IP
String podIp = System.getenv("POD_IP");
InetAddress podAddress = InetAddress.getByName(podIp);
InetSocketAddress sockAddr = new InetSocketAddress(podAddress, port);

2. 缺失JAX-RS资源配置关联 #

原有代码通过JdkHttpServerFactory.createHttpServer自动关联了resourceConfig（JAX-RS的资源配置，包含API接口的注册信息），但修改后直接调用HttpServer.create()创建服务，没有将resourceConfig绑定到HttpServer的请求处理逻辑中，导致请求到达后没有对应的处理器，表现为curl无响应。

正确代码示例：
保留JdkHttpServerFactory来关联资源配置，同时指定绑定的IP地址：

String podIp = System.getenv("POD_IP");
InetAddress podAddress = InetAddress.getByName(podIp);
InetSocketAddress sockAddr = new InetSocketAddress(podAddress, port);
// 使用工厂方法创建并关联资源配置
httpServer = JdkHttpServerFactory.createHttpServer(sockAddr, resourceConfig, false);
httpServer.start();

或者手动关联资源配置：

String podIp = System.getenv("POD_IP");
InetAddress podAddress = InetAddress.getByName(podIp);
InetSocketAddress sockAddr = new InetSocketAddress(podAddress, port);

HttpServer httpServer = HttpServer.create();
httpServer.bind(sockAddr, 5);
// 创建上下文并绑定JAX-RS处理器
HttpContext context = httpServer.createContext("/");
context.setHandler(JdkHttpServerFactory.createHandler(resourceConfig));
httpServer.start();

3. 补充代码的额外问题 #

你补充的代码中localHost变量未初始化，这会导致编译错误或运行时异常，即使侥幸运行，也可能绑定了错误的地址，再加上缺失资源配置关联，最终导致请求无响应。

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