VSCode 启动 Java 项目读取不到 Nacos 配置问题排查与解决

在使用 VSCode 启动 Java 项目 时，出现读取不到 Nacos 配置的问题，而用 IDEA 或在服务器上运行却一切正常？
很多情况下，问题并不在 Nacos，而在 Java 的域名解析顺序。

本文结合 jeecg-boot-nacos 场景，详细讲清楚问题原理与解决方案。

---

一、问题现象

项目启动时报错类似：

• 无法连接 Nacos

• 无法加载远程配置

• RedissonClient 创建失败

• 读取不到 jeecg.redisson 配置

而实际 Nacos 是通过 Docker 启动的，服务名为：

jeecg-boot-nacos

在 Docker 网络中，服务间可以通过服务名互相访问，但在宿主机（Windows / Mac）上是没有 DNS 记录的。

---

二、问题根因

1️⃣ Docker 内部服务名不能被宿主机 DNS 解析

例如：

jeecg-boot-nacos

在 Docker 内部可以解析，但在宿主机上：

ping jeecg-boot-nacos

通常会失败。

因为：

• 宿主机 DNS 并不知道这个名字

• 这个名字只存在于 Docker 内部网络

---

2️⃣ Java 默认解析顺序问题

Java 默认的主机名解析顺序通常是：

dns -> others

也就是说：

• 先查 DNS

• 查不到才尝试其他方式

如果 DNS 查不到，就会直接失败。

---

三、解决方案

核心就是两个 JVM 参数：

-Dsun.net.spi.nameservice.provider.1=hosts,dns
-Dnetworkaddress.cache.negative.ttl=0

下面逐个解释。

---

一、-Dsun.net.spi.nameservice.provider.1=hosts,dns

作用

调整 Java 的主机名解析顺序：

让 Java 先查 hosts 文件，再查 DNS。

---

默认行为

dns,others

先查 DNS。

---

修改后

hosts,dns

先查 hosts。

---

为什么必须这样？

如果你在本机 hosts 文件中配置：

127.0.0.1 jeecg-boot-nacos

那么：

• Java 会优先从 hosts 中解析

• jeecg-boot-nacos 会被解析成 127.0.0.1

• 成功连接本地映射的 Nacos 端口

---

二、-Dnetworkaddress.cache.negative.ttl=0

作用

控制 解析失败的缓存时间。

---

默认行为

如果一次 DNS 解析失败：

• Java 会缓存失败结果

• 默认缓存几秒（通常 10 秒）

这意味着：

即使你马上修改了 hosts，也不会立刻生效。

---

设置为 0

-Dnetworkaddress.cache.negative.ttl=0

效果：

• 不缓存失败结果

• 每次都会重新解析

特别适合：

• 本地调试

• 刚刚修改 hosts

• 网络刚恢复

---

四、完整解决步骤

第一步：修改 hosts 文件

Windows：

C:\Windows\System32\drivers\etc\hosts

Mac / Linux：

/etc/hosts

添加：

127.0.0.1 jeecg-boot-nacos

---

第二步：在 VSCode 中添加 JVM 参数

打开 launch.json：

{
  "type": "java",
  "name": "Launch",
  "request": "launch",
  "mainClass": "com.xxx.Application",
  "vmArgs": "-Dsun.net.spi.nameservice.provider.1=hosts,dns -Dnetworkaddress.cache.negative.ttl=0"
}

---

第三步：重新启动项目

此时：

• Java 优先读取 hosts

• jeecg-boot-nacos 被解析为 127.0.0.1

• 成功连接 Nacos

• 成功读取 jeecg.redisson

• RedissonClient 创建成功

---

五、原理流程图

正常错误流程：

Java
 ↓
DNS 查询 jeecg-boot-nacos
 ↓
查不到
 ↓
缓存失败
 ↓
启动报错

修改后的正确流程：

Java
 ↓
查 hosts
 ↓
127.0.0.1
 ↓
连接成功
 ↓
读取 Nacos 配置
 ↓
Redisson 初始化成功

---

六、为什么 IDEA 可能正常？

有几种可能：

1. IDEA 可能本身继承了不同的 JVM 参数

2. 服务器环境已经配置好 hosts

3. 服务器运行在 Docker 网络内部

而 VSCode 使用的是你本地的 JVM，默认解析顺序不同，因此暴露了问题。

---

七、总结

参数	作用
-Dsun.net.spi.nameservice.provider.1=hosts,dns	让 Java 优先查 hosts
-Dnetworkaddress.cache.negative.ttl=0	不缓存 DNS 失败结果

核心问题本质：

Docker 内部服务名无法被宿主机 DNS 解析，而 Java 默认优先查 DNS。

解决思路：

强制 Java 优先使用 hosts 映射。

---

最终结论

当你在 VSCode 启动 Java 项目时，如果：

• 使用 Docker 内部服务名

• 本地访问不到 Nacos

• 读取不到远程配置

优先检查：

1. hosts 是否配置

2. JVM 是否设置 hosts,dns

3. 是否关闭了 negative DNS 缓存