Spring Boot 项目配置 Nacos 服务注册发现时,默认服务端端口号为 8848,上下文路径为/nacos,截至 2026 年 4 月 3 日的资料显示默认账号密码为 nacos/nacos。
原因分析
Nacos Server 启动后默认监听 8848 端口,这是阿里巴巴官方设定的标准 HTTP 服务端口。在压缩包的 conf 目录中,application.properties 文件显示默认 Nacos 服务器的端口号为 8848,上下文路径为/nacos。客户端通过该端口与注册中心建立通信,若端口配置错误,服务将无法注册到控制台,浏览器访问 http://localhost:8848/nacos/index.html 也将无法打开登录页面。
解决方案
第一步:在 pom 文件中引入依赖,具体坐标为 com.alibaba.cloud 组的 spring-cloud-starter-alibaba-nacos-discovery。第二步:在应用的/src/main/resources/application.yml 配置文件中配置 NacosServer 地址,关键配置项为 spring.cloud.nacos.discovery.server-addr,默认值应设为 127.0.0.1:8848。第三步:使用@EnableDiscoveryClient 开启服务注册发现功能,确保主应用程序类添加该注解。第四步:启动应用后观察 nacos 服务列表,注意每一个应用都应该有名字,默认通过 spring.application.name 指定,这样才能注册上去。
注意事项
第一:版本差异导致鉴权配置变化,从 nacos2.2.0.1 版本开始,nacos 配置文件中去掉了默认的鉴权配置,需要用户手工添加,否则无法启动 nacos。第二:端口号混淆风险,部分教程示例中错误配置为 8748,但默认情况下 Nacos 的服务端地址端口是 8848,而不是 8748,请确保使用正确的端口。第三:自动注册行为差异,auto-register 配置表示应用要不要作为一项服务注册到 nacos 服务列表,默认是 false,若引入 nacos-discovery 只是为了获取别的服务信息而不想暴露自己的服务,可使用默认值。
参考来源
来源:【SpringCloud】Nacos 组件:服务注册与发现 - 2026 年 4 月 3 日资料
来源:SpringBoot 配置 nacos 注册中心 - 2024 年 3 月 9 日资料
来源:从零搭建微服务架构:Spring Boot 与 Nacos 完美整合 - 2024 年 2 月 5 日资料
来源:springboot 集成 nacos 服务注册发现中心 - 2023 年 5 月 31 日的资料