SpringBoot3.5.x集成Nacos 2.x全流程详解

洛枫偃月2026-01-06 16:44

写在前面

目前官方文档给的比较笼统，而且在Github的体提问大家使用的SpringBoot版本以及Nacos client版本也不相同。

SpringBoot版本

SpringBoot 3.5.9 官方LTS版本

Nacos服务端版本

NACOS 2.4.3

增加Nacos Client依赖

xml 复制代码

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2025.0.0.0</version>
</dependency>

新增配置文件application.yml

yaml 复制代码

spring:
  application:
    name: nacos-demo
  config:
        #高版本SpringBoot均要使用该方式指定需要的配置文件
    import: 
        #注意：此处一定不能加yaml后缀，否则找不到配置文件
      - nacos:${spring.application.name}  
  cloud:
    nacos:
      config:
        username: xxx
        password: xxx
        server-addr: 127.0.0.1:8848
        # 自己没有创建namespace此处默认应该是public
        namespace: nacos-self-namespace
        file-extension: yaml

升级过程Q&A

1.不再引用spring-cloud-starter-bootstrap

由于高版本SpringBoot推荐使用application.yml，不再推荐使用bootstrap.yml，

因此本版本没有使用配置文件bootstrap.yml。

2.Nacos client中logback与SpringBoot里面的冲突启动报错

在SpringBoot启动类中增加如下内容可以解决，但是目前2025版本客户端没有此报错了。

java 复制代码

 System.setProperty("nacos.logging.default.config.enabled", "false");