Java中启动Jena Docker容器时遭遇UnknownHostException问题

我来帮你排查这个问题——你遇到的UnknownHostException本质是你的Java程序所在的主机无法解析sparqlhost这个主机名，下面是具体的分析和解决方案：

核心原因 #

你通过docker run命令启动了名为sparqlhost的容器，但默认情况下：

• Docker的bridge网络不会把容器名暴露给主机的DNS解析系统
• 你虽然做了端口映射-p 3030:3030，但Java代码里用http://sparqlhost:3030访问时，主机不知道sparqlhost对应的IP是什么

快速解决方案：改用localhost访问 #

这是最简单且通用的方式，因为你已经把容器的3030端口映射到了主机的3030端口，直接把SPARQL URI改成：

String sparqlDatasetURI = "http://localhost:3030/UnitTestSet/update";

这样主机就能通过本地端口转发访问到容器里的Fuseki服务了。

可选方案：用容器名访问（适合特殊场景） #

如果因为某些需求必须用sparqlhost作为主机名，需要做两步配置：

1. 创建自定义Docker网络并启动容器
   自定义网络内的容器可以互相通过名字解析，但主机还是不行，所以先创建网络：

   docker network create jena-fuseki-net
   docker run --name sparqlhost --network jena-fuseki-net -p 3030:3030 -e ADMIN_PASSWORD=pw123 -e JVM_ARGS=-Xmx2g -d stain/jena-fuseki
   

2. 修改主机的hosts文件
   在主机的/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）里添加一行：

   127.0.0.1 sparqlhost
   

   这样主机就能把sparqlhost解析到本地回环地址，通过端口映射访问容器。

额外注意事项：容器启动延迟 #

你的Java代码在执行Runtime.getRuntime().exec()后会立刻初始化SparqlBasedSink，但Fuseki容器需要几秒时间才能完全启动服务。这时候即使主机名解析正常，也可能出现连接失败的情况。

可以添加一个简单的等待逻辑，或者更优雅地检查端口可用性：

// 简单等待10秒（根据实际情况调整时长）
Thread.sleep(10000);
// 再初始化Sink
testSink = new SparqlBasedSink(sparqlDatasetURI...);

验证容器状态 #

如果修改后还是有问题，先确认容器是否正常启动：

# 查看运行中的容器
docker ps
# 如果没找到sparqlhost，查看启动日志排查问题
docker logs sparqlhost

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