Nacos源码启动 java.net.UnknownHostException: jmenv.tbsite.net

最新推荐文章于 2025-07-10 21:43:53 发布

原创最新推荐文章于 2025-07-10 21:43:53 发布 · 880 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

SpringCloud 专栏收录该内容

49 篇文章

订阅专栏

本文讲述了在Nacos本地源码环境中遇到的启动Web服务器失败问题，解决方案是添加启动参数-Dnacos.standalone=true，成功后可启动嵌入式Tomcat。

一概述

Nacos本地源码环境提示：

Unable to start web server; nested exception is org.springframework.boot.web.server.WebServerException: Unable to start embedded Tomcat

二解决方法：

启动增加如下配置：

-Dnacos.standalone=true

启动成功的结果：

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

至学者

关注关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Caused by: java.net.UnknownHostException: jmenv.tbsite.net

知识改变命运，ヾ(◍°∇°◍)ﾉﾞ【求关注】

08-06

9367

重新启动nacos报错：

nacos启动报错

while(life)++；

06-28

2754

Nacos

参与评论您还未登录，请先登录后发表或查看评论

nacos 1.3.2启动java.net.UnknownHostException: jmenv.tbsite.net

yj2434的博客

10-27

763

具体报错如下： Caused by: java.net.UnknownHostException: jmenv.tbsite.net at java.base/java.net.InetAddress$CachedAddresses.get(InetAddress.java:797) at java.base/java.net.InetAddress.getAllByName0(InetAddress.java:1505) at java.base/java.

Nacos启动时报错 java.net.UnknownHostException: jmenv.tbsite.net

山清水不秀的博客

05-29

2746

最近由于工作需要，需要搭建nacos注册中心，使用的是2.2.3版本。

Nacos启动报错：java.net.UnknownHostException: jmenv.tbsite.net

热门推荐

Cx的博客

06-16

3万+

第一次接触Nacos，启动时报错（java.net.UnknownHostException: jmenv.tbsite.net）解决方案。错误信息：解决方案：Nacos默认是集群（cluster）启动，将其设置为单机（standalone）启动则不会报这个错。若需要集群启动则需要进行相关的集群配置。windows启动：startup.cmd -m standalonelinux启动：startup.sh -m standalone...

Nacos在启动时，遇到了启动失败的问题，错误日志中提到了 java.net.UnknownHostException: jmenv.tbsite.net

weixin_56784519的博客

04-20

2152

在启动 Nacos 服务时，遇到了启动失败的问题，具体表现为无法启动内嵌的 Tomcat 服务器。，表明 Nacos 在尝试连接一个无法解析的主机名。

nacos适配达梦、瀚高、人大金仓数据库及部分源码探究

码猿手

07-21

2069

nacos适配达梦、瀚高、人大金仓数据库

nacos启动 java.net.UnknownHostException: jmenv.tbsite.net

LiaoZe770的博客

12-18

1060

双击执行startup.cmd文件，默认是以集群方式启动nacos，由于只想用单体的并没有配置集群相关的属性，所以无法启动。解决方式：在命令行输入startup -m standalone以单机模式启动就可以了。

排查和解决CentOS系统上Nacos服务启动报错“java.net.UnknownHostException: jmenv.tbsite.net“问题

Da_zhenzai的博客

04-25

1万+

而通过指定-m standalone参数，启动Nacos单机模式，就可以避免这个问题，因为在单机模式下，Nacos不会去注册到任何服务中心中，而是直接启动自己的服务。进入nacos的logs目录（这里LZ的目录是/usr/local/nacos/nacos/logs），使用tail命令查看实时日志。进入nacos的bin目录（这里LZ的目录是/usr/local/nacos/nacos/bin），运行启动脚本。

Nacos启动报错：Caused by: java.net.UnknownHostException: jmenv.tbsite.net

QiAn的博客

10-06

4005

原因：Nacos默认是集群（cluster）启动，将其设置为单机（standalone）启动则不会报这个错。若需要集群启动则需要进行相关的集群配置。win + R --> cmd，进入到nacos/bin所在目录，输入命令 “” （此命令为单机方式启动，默认是集群方式启动）

Nacos启动报错java.net.UnknownHostException: jmenv.tbsite.net

MRX001的博客

02-13

2136

检查conf路径下面的application.properties配置文件。在bin路径下面执行sh startup.sh -m standalone。去logs日志路径下，tail -f nacos.log。

启动Nacos异常:java.net.UnknownHostException: jmenv.tbsite.net

tianynnb的博客

09-04

2417

java.net.UnknownHostException: jmenv.tbsite.net 失败操作: 命令行startup.cmd命令此时是以集群模式启动服务->失败（“nacos is starting with cluster”）解决方案: 使用命令行添加启动模式 startup -m standalone—>成功(“nacos is starting with standalone”) ...

Nacos版本差异导致的启动失败问题(Windows10下)解决办法

qq_34117294的博客

04-19

3470

将startup.cmd中的set MODE="cluster"修改为set MODE=“standalone”。在Windows10下启动Nacos1.4.1正常，但是尝试启动Nacos2.0.0时，却总是失败！部分异常如下： 2021-04-19 15:52:05,911 ERROR Startup errors : {} org.springframework.context.ApplicationContextException: Unable to start web server; neste

工具篇--Nacos 源码启动 & jmenv.tbsite.net 错误分析

拽着尾巴的鱼儿的博客

03-25

8216

本文对nacos 源码启动报 Unable to start embedded Tomcat ，报错原因及解决办法进行介绍；如果想直接看结果可以直接到。本文环境 nacos ：2.4.0;Nacos 是一个开源的服务发现、配置管理和服务管理平台，旨在帮助开发人员构建和维护微服务架构的应用。Nacos 的功能包括：服务发现和注册、配置管理、动态 DNS 服务以及服务健康监测。服务发现与注册：Nacos 提供了服务发现和注册功能，使得微服务应用能够灵活地注册和发现其他服务实例。

（已解决）Nacos启动报java.net.UnknownHostException:jmenv.tbsite.net问题

不曾留得桃花影

12-15

1万+

之前在linux上搭建了一个单机版的Nacos测试了一下后就没使用了，这几天开始做项目要使用它，启动一直报错一查看日志，好嘛全是错，试了各种方法都没解决，最后直接重新装了还是报这个错，最后去他官网一看，好嘛启动命令错了我也是醉了！！系统环境 centos 7.8 openjdk 1.8 maven3.0 nacos 1.3.1 解决办法：一、单机模式 ./startup.sh -m standalone 二、集群模式 ./startup.sh #默认就是集群 ...

启动Nacos报错(Caused by: java.net.UnknownHostException: jmenv.tbsite.net)

qq_60361946的博客

11-07

2540

解决方法： Nacos默认使用的是集群(cluster)启动的，将其设置为单机启动(standalone)即可。若需要集群启动则需要相关的集群配置。

nacos 1.3启动java.net.UnknownHostException: jmenv.tbsite.net

动哒APP—运动健康科技提供商

05-27

1万+

好久没用nacos，今天一用，竟然启动不了。最后的报错如下： Caused by: java.net.UnknownHostException: jmenv.tbsite.net at java.base/java.net.InetAddress$CachedAddresses.get(InetAddress.java:797) at java.base/java.net.InetAddress.getAllByName0(InetAddress.java:1505)

解决Nacos2.4启动报 /logs/access_log.x-x-x-x.log (权限不够)、java.net.UnknownHostException: jmenv.tbsite.net

码农的艺术

07-10

1430

解决Nacos2.4启动报 /logs/access_log.x-x-x-x.log (权限不够)、java.net.UnknownHostException: jmenv.tbsite.net

nacos 报错：java.net.UnknownHostException: jmenv.tbsite.net

最新发布

10-29

<think>嗯，用户的问题是关于Nacos启动报错"java.net.UnknownHostException: jmenv.tbsite.net"的解决方案。结合引用内容来看，这确实是个典型问题，用户应该正在部署Nacos时遇到了阻碍。用户明确参考了三篇站内引用，说明已经做过基本调研。不过从提问方式看可能是运维或开发人员，不太熟悉Nacos的集群配置机制。ta的诉求很聚焦——只要解决方案，不需要原理阐述，但作为专业回答还是需要包含必要的技术背景。引用[1][2][3]都指向同一个核心原因：Nacos默认集群模式需要连接jmenv.tbsite.net这个域名。有趣的是三个引用提供了相同的解决方案路径：单机模式启动或正确配置集群。其中引用[3]的解释最透彻——原来jmenv.tbsite.net是Nacos内置的服务发现域名。考虑到用户环境，需要强调两个关键点：如果是测试环境直接用单机模式最省事；如果是生产集群则必须配置cluster.conf。特别要注意引用[2]提到的网络访问问题，很多企业内网会屏蔽外部域名解析。在组织回答时，应该把单机模式方案放在首位，因为这是用户最可能需要的快速方案。但也不能忽略集群配置的说明，毕竟引用[2]特别强调了这是默认启动模式的根本原因。最后补充的DNS检查也很必要，这是引用[2][3]都提到的隐藏痛点。用户没有说明操作系统环境，所以需要同时给出Windows和Linux的命令示例。突然想到引用[1]提到/logs权限问题，虽然用户没问但可能在后续出现，要不要作为附加提醒呢？还是保持专注只解决当前报错吧。 </think>好的，根据提供的站内引用信息和Nacos常见问题，以下是解决 `java.net.UnknownHostException: jmenv.tbsite.net` 报错的详细方案： **核心原因分析：** 该错误表明 Nacos 服务在启动时，默认尝试以**集群模式（Cluster Mode）**运行。在这个模式下，Nacos 需要访问一个名为 `jmenv.tbsite.net` 的地址服务器（address-server）来获取或确认集群成员的列表信息。如果出现以下情况之一，就会导致这个域名无法解析（UnknownHostException），进而启动失败 [^1][^2][^3]： 1. **运行环境网络问题**：运行 Nacos 的服务器无法访问互联网（`jmenv.tbsite.net` 本身是一个公共域名），或者服务器配置的 DNS 服务不可用/无法解析外部域名。 2. **非集群需求却使用集群启动**：您当前仅需单机运行 Nacos 进行开发、测试或小型应用，不需要集群功能，但未明确指定启动模式。 3. **集群配置错误**（如果确实需要集群）：虽然引用主要指向单机模式解决方案，但如果是真正的生产集群环境配置错误（如 `cluster.conf` 配置错误或地址服务器指向错误），也可能触发类似问题（虽然更常见的结果是节点无法加入集群而非启动失败）。 **解决方案：** 根据您的实际需求，选择以下两种方案之一： **方案一：使用单机模式启动（推荐用于开发测试或个人学习）** 这是解决此报错**最快速、最常用且最有效**的方法，尤其当您不需要 Nacos 集群功能时 [^1][^2][^3]。 1. **定位 Nacos 启动脚本**： * 在您的 Nacos 安装目录下，找到 `bin` 文件夹。 * Windows 系统：找到 `startup.cmd` * Linux/Unix/Mac 系统：找到 `startup.sh` 2. **修改启动命令**： * **Windows**: 打开命令提示符（CMD）或 PowerShell，导航到 Nacos 的 `bin` 目录，执行： ```bash startup.cmd -m standalone ``` * **Linux/Unix/Mac**: 打开终端（Terminal），导航到 Nacos 的 `bin` 目录，执行： ```bash sh startup.sh -m standalone # 或者赋予执行权限后直接运行 # chmod +x startup.sh # ./startup.sh -m standalone ``` **关键点解释：** * `-m` 参数用于指定 Nacos 的启动模式。 * `standalone` 明确告诉 Nacos 以单机模式启动。 * 在单机模式下，Nacos **不会** 尝试连接 `jmenv.tbsite.net` 或任何外部地址服务器来寻找集群节点，因此完全规避了域名解析失败的问题 [^1][^2][^3]。它只启动一个独立的服务实例。 **方案二：配置集群模式（仅在您确实需要多节点集群时使用）** 如果您部署的是生产环境，需要多个 Nacos 节点组成高可用集群，则需要正确配置集群环境，而不是简单地使用单机模式。 1. **配置 `cluster.conf`**： * 进入 Nacos 安装目录下的 `conf` 文件夹。 * 找到或创建一个名为 `cluster.conf` 的文件（通常有一个示例文件 `cluster.conf.example`，复制一份并重命名为 `cluster.conf`）。 * 编辑 `cluster.conf`，**删除**原有示例内容，**按行添加**集群中**所有** Nacos 节点的 **IP:PORT**（端口是 Nacos 集群通信端口，默认是 `7848` 之后的一个偏移量，通常是 `7848` 或 `8848` 的同服务器端口，建议明确配置为 `7848`）。例如： ``` # 假设有三个节点，IP 分别是 192.168.1.101, 192.168.1.102, 192.168.1.103 192.168.1.101:7848 192.168.1.102:7848 192.168.1.103:7848 ``` * **重要：确保所有节点使用相同的 `cluster.conf` 配置，且文件中的 IP 和端口在所有节点间都是可互相访问的。** 2. **移除或修正地址服务器配置（可选但推荐）**： * 默认配置可能会尝试连接 `jmenv.tbsite.net`。更推荐使用明确的 `cluster.conf`。 * 检查 `conf` 目录下的 `application.properties` 文件。 * 查找 `nacos.core.auth.enabled`, `nacos.core.member.list` 等集群相关配置。对于 `cluster.conf` 方式，通常不需要设置 `nacos.core.address-server`。如果存在类似 `nacos.core.address-server=xxx` 的配置（可能指向 `jmenv.tbsite.net`），请**注释掉**该行（在行首加 `#`）或将其值设置为空字符串 `nacos.core.address-server=` [^2]。 3. **确保网络互通**： * 检查集群内所有服务器节点之间在配置的端口（默认 `7848`）上是否能互相访问（使用 `telnet` 或 `nc` 命令测试）。 * 如果服务器位于内网，确保其网络配置允许内部节点间通信。 4. **启动集群节点**： * 在**每个** Nacos 节点上，**不需要**加 `-m standalone` 参数，直接运行启动脚本： ```bash # Windows startup.cmd # Linux/Unix/Mac sh startup.sh # 或 ./startup.sh ``` * Nacos 会读取 `cluster.conf` 文件并使用其中定义的节点信息组成集群。 **附加检查（适用于两种方案）：** * **防火墙/Security Group**：确保运行 Nacos 的服务器端口（默认 `8848` 用于控制台/API，`7848` 用于集群通信）对需要访问它的客户端（和集群节点之间）是开放的。 * **DNS 解析**（如果问题持续且方案一无效）： * 在运行 Nacos 的服务器上，手动测试是否能解析 `jmenv.tbsite.net`： ```bash ping jmenv.tbsite.net # 看是否能通 nslookup jmenv.tbsite.net # 看是否能解析出IP ``` * 如果无法解析，检查服务器的 DNS 配置（`/etc/resolv.conf` on Linux）。如果服务器完全不能出公网，除了单机模式，也需确保所有必要的域名都在内部 DNS 或 hosts 文件中正确解析。 **总结：** 对于绝大多数遇到 `java.net.UnknownHostException: jmenv.tbsite.net` 错误的用户，根本原因是**在不需要集群的环境下使用了集群模式启动**。**最直接有效的解决方案就是在启动命令中加入 `-m standalone` 参数，以单机模式运行 Nacos**[^1][^2][^3]。只有在部署高可用生产集群时，才需要按照方案二仔细配置 `cluster.conf` 并确保网络环境。