记录spring cloud + nacos使用配置中心过程中的一些问题及解决方法

一、相关配置/依赖版本

父工程下pom.xml配置如下：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.6.13</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>2021.0.5</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>

    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-alibaba-dependencies</artifactId>
        <version>2021.0.5.0</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>

    <!-- Spring Web 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-bootstrap</artifactId>
        <version>3.1.0</version>
    </dependency>

    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.3.2</version>
    </dependency>

    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
        <version>4.1.3</version>
    </dependency>
</dependencies>

这里采用的是spring boot 2.6.13 + spring cloud 2021.0.5

子项目配置如下：

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

二、nacos配置中心

nacos下载版本为nacos-server-2.3.0，下载nacos后解压缩，gitHub访问不了的话从这里下载Nacos Server 下载 | Nacos

这里在启动nacos之前需要检查环境变量中系统变量是否含有JAVA_HOME及路径，如果没有则启动nacos会报错：Please set the JAVA_HOME variable in your environment, We need java(x64) jdk8 or later

解决方案：配置JAVA_HOME如下图所示（注意这里不要把链接写到bin）

 可以查看nacos的启动脚本，JAVA_HOME是硬性要求，当然也可以直接在cmd文件中指定JAVA_HOME的值，这样的话不配置JAVA_HOME也可以启动。

 

之后打开CMD命令窗口，cd到nacos的bin目录下，

执行startup.cmd -m standalone ，以单机模式启动nacos

正常情况下，CMD窗口如图所示

现在http://localhost:8848/nacos查看一下，如果需要账号和密码，输入默认账号密码nacos即可，至此nacos启动成功，接下来处理后端相关的配置。

三、服务端配置

spring boot项目中默认可以添加application.yml做配置管理，我这里选择的是bootstrap.yml去做配置管理，使用spring cloud 2021时需要显式引入spring-cloud-starter-bootstrap以启用bootstrap（有一些文章是用spring-cloud-starter-config实现bootstrap，但是这样的话实现配置中心就是另外的方法了，而且会出现No spring.config.import property has been defined），之后在子项目创建bootstrap.yml，替换掉原先的application.yml。（我这边额外多配置了bootstrap-dev.yml）

bootstrap.yml:

spring:
  profiles:
    active: dev

bootstrap-dev.yml:

server:
  port: 10011

spring:
  application:
    name: user_provider  #服务名称
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

      config:
        server-addr: 127.0.0.1:8848 #Nacos作为配置中心地址
        file-extension: yaml #指定yaml格式的配置
        import-check:
          enabled: false

test: aaaaaa

此时我们创建一个controller测试配置中心是否可用，其中@RefreshScope表示自动刷新配置 ：

在启动类前加如下注解启用微服务发现功能，保证你的模块可以注册到naocs上：

 接下来回到nacos页面上，此时应该可以看到模块已经出现在服务列表：

 接下来我们可以将其添加至配置中心，配置管理->配置列表->创建配置:

 官方对于dataId要求如下：

如果之前只创建了bootstrap.yml，这里的dataId应该是XXXX,yaml（注意是yaml不是yml），我多配了一个dev的yml，并且指定了active: dev，所以我这里是XXXX-dev.yaml，配置格式理所当然应该是YAML。

在配置里添加如下内容：

输入接口地址后可以看到配置采用的是nacos中的配置，至此配置中心已生效。

四、结语 

1. 配置依赖的时候如果出现pom标红，无法识别的时候，maven去Reload一下

2.安装依赖的时候maven出现time out，更改maven的配置文件再尝试一下，镜像使用ali的

    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>        
    </mirror>

3.关闭本地nacos

4.spring boot ，spring cloud，spring cloud ali版本对照可以看github上阿里发布的spring cloud版本说明