SpringBoot+Nacos+OpenFeign环境搭建

已于 2023-03-07 17:12:53 修改
阅读量2.4k 收藏 4
点赞数 1
分类专栏： 个人笔记 文章标签： spring boot java spring
于 2023-03-01 14:55:20 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hauchun/article/details/129237675
版权

目录

1.boot方式nacos与openFeign集成

1.引入依赖

2.添加配置

3.测试接口调用

4.常见问题：

       1.版本依赖

       2.nacos客户端

2.cloud方式nacos与openFeign集成 

1.引入依赖

2.添加配置

3.接口定义

4.开启FeignClients客户端

5.远程接口测试

6.Nacos配置中心

3.常见问题

1.Get请求接口带参数无法传递

1.boot方式nacos与openFeign集成

1.引入依赖

        说明：参考下面依赖

<properties>        
        <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
        <spring-cloud-alibaba.version>2.2.6.RELEASE</spring-cloud-alibaba.version>
        <spring-boot.version>2.3.6.RELEASE</spring-boot.version>
        <alibaba-fastjson.version>2.0.20</alibaba-fastjson.version>
</properties>

<dependencies>

        <!--  引入nacos配置中心依赖   -->
        <dependency>
            <groupId>com.alibaba.boot</groupId>
            <artifactId>nacos-config-spring-boot-starter</artifactId>
            <version>${com.alibaba.boot.version}</version>
        </dependency>

        <!--  引入注册中心依赖  -->
        <dependency>
            <groupId>com.alibaba.boot</groupId>
            <artifactId>nacos-discovery-spring-boot-starter</artifactId>
            <version>${com.alibaba.boot.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-netflix-ribbon</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-loadbalancer</artifactId>
        </dependency>

        <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
            <version>2.1.1</version>
        </dependency>

</dependencies>

<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud-alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>fastjson</artifactId>
                <version>${alibaba-fastjson.version}</version>
            </dependency>

            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

2.添加配置

        

原文参考：SpringCloud-Alibaba-Nacos配置项详解_nacos配置文件详解_JavaMN的博客-CSDN博客

3.测试接口调用

4.常见问题：

       1.版本依赖

        版本如果不匹配也是会出现一些乱七八糟的问题，参照我上面的版本来问题就可以正常使用

       2.nacos客户端

说明：java.lang.NoClassDefFoundError: com/alibaba/nacos/client/utils/StringUtils

出现这个异常时候请把下面这个依赖加进去,这里需要注意版本，否则会有连接不上的情况

 <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
            <version>1.1.4</version>
 </dependency>

参考： springboot+openFeign+nacos开发实战_openfeign整合nacos_wh柒八九的博客-CSDN博客

2.cloud方式nacos与openFeign集成 

1.引入依赖

重要的事情说三遍。。。。

版本信息非常重要，一定要对应上!!!

版本信息非常重要，一定要对应上!!!

版本信息非常重要，一定要对应上!!!

<spring-boot.version>2.3.7.RELEASE</spring-boot.version>
<spring-cloud-alibaba.version>2.2.1.RELEASE</spring-cloud-alibaba.version>

<dependencyManagement>
		<dependencies>
			<!-- SpringCloud 微服务 -->
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>Hoxton.SR3</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
			<dependency>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-dependencies</artifactId>
				<version>${spring-boot.version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
			<dependency>
				<groupId>com.alibaba.cloud</groupId>
				<artifactId>spring-cloud-alibaba-dependencies</artifactId>
				<version>${spring-cloud-alibaba.version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>

			<dependency>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-starter</artifactId>
			</dependency>

		</dependencies>
	</dependencyManagement>

    <dependencies>
        <!-- https://segmentfault.com/q/1010000021044375?bd_source_light=4746641 -->
		<dependency>
			<groupId>com.alibaba.cloud</groupId>
			<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
		</dependency>
		<dependency>
			<groupId>com.alibaba.cloud</groupId>
			<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
		</dependency>
		<dependency>
			<groupId>com.alibaba.cloud</groupId>
			<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
			<exclusions>
				<exclusion>
					<artifactId>jackson-dataformat-xml</artifactId>
					<groupId>com.fasterxml.jackson.dataformat</groupId>
				</exclusion>
			</exclusions>
		</dependency>

		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-openfeign</artifactId>
		</dependency>
    </dependencies>

2.添加配置

使用cloud方式需要换成bootstrap文件，我选择bootstrap.yaml

server:
  port: 9427
nacos:
  server-addr: 127.0.0.1:8848
  #local环境
  namespace: 4e335d42-4caa-49b0-b209-0363e1a2071c
  config-group: ocpx
  # 服务只能同组调用 https://developer.aliyun.com/ask/317473
  discovery-group: delivery

spring:
  application:
    name: delivery-ocpx
  profiles:
    active: ${BOOT_ENV}

  cloud:
    nacos:
      discovery:
        server-addr: ${nacos.server-addr}
        namespace: ${nacos.namespace}
        group: ${nacos.discovery-group}
        service:  ${spring.application.name}
      config:
        server-addr: ${nacos.server-addr}
        namespace: ${nacos.namespace}
        group: ${nacos.config-group}
        file-extension: yml
        extension-configs:
          - data-id: ocpx-config.yml
            group: ${nacos.config-group}
            refresh: true

3.接口定义

请保持和目标服务的请求接口一致

package com.hhmt.delivery.chain.service;

import com.hhmt.delivery.continer.ServiceMode;
import com.hhmt.delivery.core.domain.ResultVo;
import com.hhmt.delivery.core.page.TableDataInfo;
import com.hhmt.delivery.pojo.model.query.HhChainApiInfoQuery;
import com.hhmt.delivery.pojo.model.vo.HhChainApiInfoVo;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 链路api信息Service接口
 *
 * @author hauchun
 * @date 2023-02-09
 */
@FeignClient(name = ServiceMode.CHAIN_SERVICE_NAME, path = "/chain/HhChainApiInfo")
public interface IHhChainApiInfoService {
    /**
     * 查询链路api信息
     *
     * @param id 链路api信息主键
     * @return 链路api信息
     */
    @GetMapping(value = "/{id}")
    public ResultVo<HhChainApiInfoVo> selectHhChainApiInfoById(@PathVariable("id") Long id);

    /**
     * 查询链路api信息列表
     *
     * @param hhChainApiInfo 链路api信息
     * @return 链路api信息集合
     */
    @GetMapping("/list")
    public TableDataInfo<HhChainApiInfoVo> selectHhChainApiInfoList(@RequestParam("hhChainApiInfo") HhChainApiInfoQuery hhChainApiInfo);

}

需要注意的是这里的接口入参，虽然在目标服务中可以不使用@RequestParam去定义，但是在这里是需要带上的，否则参数绑定不上

4.开启FeignClients客户端

package com.hhmt.delivery;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

@EnableFeignClients
@EnableDiscoveryClient
@SpringBootApplication
public class DeliveryOcpxApplication {

    public static void main(String[] args) {
        SpringApplication.run(DeliveryOcpxApplication.class, args);
    }

}

注意需要添加的注解：

在启动类添加这两个注解：
1.@EnableFeignClients 启用Feign客户端
2.@EnableDiscoveryClient 开启注册功能，可以将当前服务注册进注册中心

5.远程接口测试

在当前服务定义两个接口，通过调用feign定义接口，测试目标服务列表和详情接口是否可以正常调用

1.编写控制器

package com.hhmt.delivery.chain.controller;

import com.hhmt.delivery.chain.service.IHhChainApiInfoService;
import com.hhmt.delivery.core.domain.ResultVo;
import com.hhmt.delivery.core.page.TableDataInfo;
import com.hhmt.delivery.pojo.model.query.HhChainApiInfoQuery;
import com.hhmt.delivery.pojo.model.vo.HhChainApiInfoVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author huachun
 * @version 1.0
 * @description: TODO
 * @email huachun_w@163.com
 * @date 2023-03-01 11:40
 */
@RestController
@RequestMapping("/chain/HhChainApiInfo")
public class HhChainApiInfoController {

    @Autowired
    private IHhChainApiInfoService hhChainApiInfoService;

    @GetMapping("/list")
    public TableDataInfo<HhChainApiInfoVo> chainApiList() {
        TableDataInfo<HhChainApiInfoVo> chainApiInfoVoTableDataInfo = hhChainApiInfoService.selectHhChainApiInfoList(new HhChainApiInfoQuery());
        return chainApiInfoVoTableDataInfo;
    }

    @GetMapping("/{id}")
    public ResultVo<HhChainApiInfoVo> byId(@PathVariable("id") Long id) {
        ResultVo<HhChainApiInfoVo> chainApiInfoVoResultVo = hhChainApiInfoService.selectHhChainApiInfoById(id);
        return chainApiInfoVoResultVo;
    }

}

2.接口调用测试

列表接口测试

 详情接口测试

至此，openFeign远程调用功能已经完成

6.Nacos配置中心

1.需要指定当前类使用的是哪个配置(如果配置文件与规则不相匹配)

@NacosConfigurationProperties(dataId = "delivery-ocpx.yml", groupId = "ocpx")
2.使用value注解替换NacosValue注解
@Value

示例如下图所示：

3.常见问题

1.Get请求接口带参数无法传递

我在客户端定义了feign接口，想要调用服务端接口

这是客户端feign接口，此时和服务端接口保持了一致

服务端接口 

 此时虽然接口可以正常调用，但是用来过滤的条件参数却无法传递

此时调用客户端接口测试

服务端此时接受不到参数

解决办法：在客户端使用 @SpringQueryMap注解

更换注解后问题完美解决

参考原文：Spring Cloud使用OpenFeign调用接口各种问题 - 简书

春卷-huachun
关注
  • 1
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
Spring Boot项目整合Nacos, openfeign,hystrix。
JB091的博客
05-17 814
前言：公司之前的项目是单体架构，多个业务都在一个应用里面，用的ruoyi的Spring Boot单体架构，入职没几天，领导说项目并发量上来了，要把业务拆分成不同的服务，这时候招我进来的A同事说了她的想法，拆成单体的Spring boot分布式项目，个人更倾向拆成Spring Cloud微服务架构，激烈讨论了几天，A同事强硬说要搞成单体的分布式服务架构，不搞微服务架构，毕竟我是A同事内推，面试进来的，那就按她的方案搞吧（哈哈，技术架构选型人家选新的，我们选落后，倒退的）。，好吧，那就用吧）。
Springboot + SpringCloud + Nacos + OpenFeign + Gateway
Max_gao1024的博客
02-27 535
Springboot + SpringCloud + Nacos + OpenFeign + Gateway
SpringBoot集成Nacos服务注册发现
最新发布
一份努力一份收获
07-25 640
NamingService如何注入？
SpringBoot集成Nacos和Open Feign
qq_42822736的博客
04-15 1282
Spring Boot 集成 nacos 和 feign
Nacos（三）：Nacos与OpenFeign的对接使用
热门推荐
LarsCheng's Blog
07-10 3万+
前言 上篇文章中，简单介绍了如何在SpringCloud项目中接入Nacos作为注册中心，其中服务消费者是通过RestTemplate+Ribbon的方式来进行服务调用的。 实际上在日常项目中服务间调用大都用的是OpenFeign, OpenFeign自身整合了Ribbon和Hystrix，为服务调用提供了更优雅的方式 那么接入了Nacos之后，服务调用还能用这一套吗？ 通过我在公司项目上的试...
SpringCloud Alibaba | Nacos(三)：Nacos集成OpenFeign
苏老师的博客
12-23 5449
nacos 集成 openFegin
Spring Boot + Nacos + OpenFeign实现远程调用
qq_40980826的博客
10-22 2142
前文： 实现的是最简单的远程调用，不涉及数据库和业务逻辑，（让你有手就会调）在使用远程调用之前，我们先来了解一下这里远程调用其涉及到的组件的原理！ nacos的原理 nacos称之为注册中心，注册中心主要涉及到三大角色 服务提供者 服务消费者 注册中心 它们的关系如下： 各个微服务在启动时，将自己的网络地址等信息注册到注册中心，由注册中心来存储这些数据。 服务消费者从注册中心中查询服务提供者的地址，并通过地址调用服务提供者的接口。 各个微服务与注册中心使用一定的机制通信，比如说心跳；如果注册中心与微服
SpringCloud OpenFeign + Nacos正确打开方式！
磊哥聊Java
03-22 547
作者 | 磊哥来源 | Java中文社群（ID：javacn666）转载请联系授权（微信ID：GG_Stone）Nacos 支持两种 HTTP 服务请求，一个是 REST Template，另一个是 Feign Client。之前的文章咱们介绍过 Rest Template 的调用方式，主要是通过 Ribbon（负载均衡） + RestTemplate 实现 HTTP 服...
SpringBoot+SpringCloud+nacos+gateway+mybatis搭建微服务
11-09
整合这些技术，首先需要创建Spring Boot项目，然后引入Spring Cloud的相关依赖，包括Spring Cloud Netflix Eureka（服务发现）、Spring Cloud Config（配置中心）、Spring Cloud OpenFeign（服务调用）等。...
基于springcloud+springboot+nacos+openFeign的分布式事务组件seata项目源码.zip
02-27
基于springcloud+springboot+nacos+openFeign的分布式事务组件seata项目源码.zip 介绍 分布式事务组件seata的使用demo，AT模式、TCC模式，集成springboot、springcloud（nacos注册中心、openFeign服务调用、Ribbon...
搭建spring-cloud-alibaba微服务项目：springBoot服务+nacos注册中心+nacos配置中心+feign服务交互+gateway网关
yang_zeng的博客
11-12 1135
cloud-alibaba微服务搭建
Nacos服务注册发现（SpringBoot + SpringCloud + Nacos + Feign 搭建简单的微服务小 Demo）
xxh_1229的博客
09-27 1173
SpringBoot + SpringCloud + Nacos + Feign 搭建简单的微服务小 Demo 一、Nacos 快速搭建 Nacos 快速搭建 二、小Demo工程搭建 1. 首先创建一个 Empty Project 点击 finish 2.创建 SpringBoot Modules ，命名为 provider 3.点击 OK , 即可创建 springboot 项目 点击 Next 点击 Next 到这里我已经设置好一个provider服务，以此类推创建consumer 服务
springboot+openFeign+nacos开发实战
wh柒八九的博客
04-08 3055
前面说了dubbo+nocas开发实战，现在来说下springboot+openFegin+nacos开发实战。
nacos 整合 openfeign实现远程调用
北尘
06-25 1168
return "服务提供者，支付接口，支付金额为：" + id + "元，端口：" + serverPort;创建一个接口，并使用@FeignClient(name = "service-provider" ) // 指定提供者服务的名称)通过以上步骤，我们成功地将 Nacos 与 OpenFeign 整合，实现了服务提供者与服务消费者之间的远程调用。这种架构模式不仅简化了服务调用的过程，还提高了系统的可扩展性和可维护性。
Nacos+openfeign
JemeryShen的专栏
08-15 688
Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。配置服务消费者，从而服务消费者可以通过 Nacos 的服务注册发现功能从 Nacos server 上获取到它要调用的服务。从 Nacos 1.3.1 版本开始，数据库存储已经升级到8.0，并且它向下兼容。在启动服务后也能在Nacos 服务列表中查看到。2、通过 Spring Cloud 原生注解。http://ip:端口号/nacos。开启服务注册发现功能。.
OpenFeign 整合 Nacos负载均衡原理
zhao_god的专栏
08-04 4453
这个方法是整个OpenFeign初始化客户端的核心，它注册了一个FeignClientFactoryBean类，这个类实现了FactoryBean接口，它是Spring中一个特殊的类，它可以返回“一类”对象，主要方法是getObject方法。这里就到了客户端负载均衡选择服务的地方了这里面有个细节是代码无法跟到的，在选择服务器，Nacos重写了ribbon的ServerList，这就是为什么ribbon可以读到Nacos注册中心的服务。进入submit方法，注意看selectServer()方法。...
springboot 集成 openfeign、nacos
mml12464的博客
03-27 312
3.在cs-product-api FeignProductService接口中加@FeignClient(value = "cs-product",path = "/product")，写接口方法 注：如有参数必须写名称。connect-timeout: 10000 #请求连接的超时时间。name: cs-custom # 微服务的名称。-- nacos 服务配置中心 -->-- nacos 服务注册中心-->-- 声明式服务调用 -->-- 负载均衡依赖 -->--声明式服务连接池-->
SpringCloud OpenFeign + Nacos
weixin_42257298的博客
03-29 1934
SpringCloud OpenFeign + Nacos
开启一个spring cloud工程-第五步 使用Ribbon 实现负载均衡
chenmaolin928的博客
10-19 241
Ribbon 负载均衡 什么是Ribbon Spring Cloud Ribbon是一个负载均衡解决方案，Ribbon 是Netflix 发布的负载均衡器，Spring Cloud Ribbon 是给予Netfilx Ribbon 实现的，是一个用于对HTTP请求进行控制的负载均衡客户端。 在注册中心对Ribbon 进行注册之后，Ribbon 就可以基于某种负载均衡算法，如轮询、随机、加权轮询、加权随机等自动帮助服务消费者调用接口，开发者也可以根据具体需求自定义Ribbon负载均衡算法。实际开发中，Spri
springboot+nacos
07-14
Spring Boot可以通过Nacos来管理配置信息。Nacos是一个开源的分布式配置中心，可以实现配置的动态管理和实时推送。Spring Boot整合Nacos配置的步骤如下： 1. 引入依赖 在pom.xml文件中添加以下依赖： ``` <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> <version>2.2.1.RELEASE</version> </dependency> ``` 2. 配置Nacos地址 在application.properties或application.yml文件中配置Nacos的地址： ``` spring.cloud.nacos.config.server-addr=127...1:8848 ``` 3. 配置应用名称和配置文件名 在application.properties或application.yml文件中配置应用名称和配置文件名： ``` spring.application.name=myapp spring.cloud.nacos.config.file-extension=properties ``` 4. 创建配置文件 在Nacos中创建配置文件，文件名为`${spring.application.name}.${spring.cloud.nacos.config.file-extension}`，例如`myapp.properties`。 5. 获取配置信息 在代码中通过`@Value`注解获取配置信息： ``` @Value("${key}") private String value; ``` 以上就是Spring Boot整合Nacos配置的基本步骤。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值