若依前后端分离版集成nacos

news2024/12/23 4:09:56

根据公司要求，需要将项目集成到nacos中，当前项目是基于若依前后端分离版开发的，若依的版本为3.8.3，若依框架中整合的springBoot版本为2.5.14。Nacos核心提供两个功能：服务注册与发现，动态配置管理。

一、服务注册与发现

1、引入pom依赖

     </dependency>-->
        <!-- 在SpringBoot 2.4.x的版本之后，对配置文件加载方式进行了重构，需要导入如下的依赖;
        详情见官网：https://docs.spring.io/spring-cloud-config/docs/current/reference/html/#config-first-bootstrap -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
            <version>3.0.1</version>
        </dependency>

        <!-- 服务注册与发现依赖 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
            <version>2021.1</version>
        </dependency>

2、bootstrap.yml配置

spring:
  # nacos配置
  cloud:
    nacos:
      discovery:
        server-addr: 10.2.XX.XX:8848
    compatibility-verifier:
      enabled: false

3、添加注解

在项目启动类上添加 @EnableDiscoveryClient 注解：

@EnableDiscoveryClient
@SpringBootApplication(exclude = { DataSourceAutoConfiguration.class })
public class RiskExamineApplication
{
    public static void main(String[] args)
    {
        // System.setProperty("spring.devtools.restart.enabled", "false");
        SpringApplication.run(RiskExamineApplication.class, args);
        System.out.println("(♥◠‿◠)ﾉﾞ  若依启动成功   ლ(´ڡ`ლ)ﾞ  \n" +
                " .-------.       ____     __        \n" +
                " |  _ _   \\      \\   \\   /  /    \n" +
                " | ( ' )  |       \\  _. /  '       \n" +
                " |(_ o _) /        _( )_ .'         \n" +
                " | (_,_).' __  ___(_ o _)'          \n" +
                " |  |\\ \\  |  ||   |(_,_)'         \n" +
                " |  | \\ `'   /|   `-'  /           \n" +
                " |  |  \\    /  \\      /           \n" +
                " ''-'   `'-'    `-..-'              ");
    }
}

4、验证

项目启动后，登录nacos，在服务列表中，点击查询即可看到注册到nacos的服务，如下图：

服务名默认为yml配置里spring.application.name的名称，也可通过spring.cloud.nacos.discovery.service配置指定。

遇到问题：Your project setup is incompatible with our requirements due to following reasons:
- Spring Boot [2.5.14] is not compatible with this Spring Cloud release train

Change Spring Boot version to one of the following versions [2.3.x, 2.4.x]


***************************
APPLICATION FAILED TO START
***************************

Description:

Your project setup is incompatible with our requirements due to following reasons:

- Spring Boot [2.5.14] is not compatible with this Spring Cloud release train


Action:

Consider applying the following actions:

- Change Spring Boot version to one of the following versions [2.3.x, 2.4.x] .
You can find the latest Spring Boot versions here [https://spring.io/projects/spring-boot#learn]. 
If you want to learn more about the Spring Cloud Release train compatibility, you can visit this page [https://spring.io/projects/spring-cloud#overview] and check the [Release Trains] section.
If you want to disable this check, just set the property [spring.cloud.compatibility-verifier.enabled=false]

解决办法：出现这个问题是由于springBoot和springCloud版本不一致导致的，如果是自己手动搭建的框架，可以根据提示将springBoot版本降到[2.3.x, 2.4.x]；但是由于我用的是若依的框架，担心将springBoot版本降低后会引起其它问题，所以根据提示设置spring.cloud.compatibility-verifier.enabled=false这个属性，但是引入后发现配置不生效，最后根据研究一番之后，根据网上的提示需将配置文件名称application.yml改为bootstrap.yml，然后再引入依赖spring-cloud-starter-bootstrap 即可解决。

注意：如果只需要nacos的服务注册与发现功能，不用服务配置功能的话，一定要将服务配置的pom依赖（spring-cloud-starter-alibaba-nacos-config）去掉，否则启动时会报错：currentServerAddr:http://localhost:8848， err : connect timed out 。

二、服务动态配置与服务注册发现

1、引入pom依赖

  <!-- nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            <version>2021.1</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
            <version>3.0.1</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
            <version>2021.1</version>
        </dependency>

2、bootstrap.yml配置

spring:
  cloud:
    nacos:
      discovery:
        server-addr: 124.70.XX.XX:32389
        namespace: zs-smart
        group: dev
      config:
        server-addr: 124.70.XX.XX:32389
        namespace: zs-smart
        group: dev
        name: zs-smart
        file-extension: yaml
    compatibility-verifier:
      enabled: false

3、nacos配置

1）新建命名空间