配置Gateway+nacos资料：新手入门教程

本文详细介绍了如何配置Gateway+nacos资料，包括环境准备、Spring Boot项目创建、Gateway路由配置以及使用Nacos作为配置中心的步骤，确保服务发现和动态配置管理的顺利进行。

Gateway简介

Gateway 是一个基于 Spring Cloud Gateway 框架的 API 网关，用于处理 HTTP 请求的路由、过滤和转发。其主要功能包括：

• 路由转发：将请求路由到不同的服务或微服务中。
• 请求过滤：在请求到达真实服务之前，进行预处理或后处理，如添加或修改请求头、请求体等。
• 安全控制：实现身份验证、权限控制等安全措施。
• 限流和熔断：提供请求限流和熔断机制，保护服务免受高并发请求的冲击。

Nacos简介

Nacos 是一个动态服务发现、配置管理和服务管理平台，主要功能包括：

• 服务发现与负载均衡：支持服务注册与发现，实现客户端自动发现服务并进行负载均衡。
• 动态配置管理：支持配置的动态分发，可以在运行时修改配置而不需重启服务。
• 服务管理：提供对服务的管理能力，包括服务治理、服务健康状态监控等。

安装Java开发环境

为了运行Spring Boot应用，首先需要安装Java开发环境。请确保已经安装了Java开发工具包（JDK），并且环境变量已经正确配置。以下命令用来检查Java是否已安装：

java -version

若未安装，请下载对应版本的JDK，安装完成后设置环境变量，确保Java路径被添加到系统环境变量中。例如：

export JAVA_HOME=/path/to/jdk
export PATH=$JAVA_HOME/bin:$PATH

下载与安装Nacos

Nacos可以作为配置中心和注册中心。以下是安装步骤：

1. 访问Nacos官方GitHub仓库下载最新版本的压缩包。
2. 解压下载的压缩包。
3. 进入解压后的文件夹，运行启动命令：

sh bin/startup.sh -m standalone

1. 访问 http://localhost:8848/nacos，默认用户名密码为`nacos/nacos`，进入Nacos控制台。

下载与安装Spring Boot

为了创建Spring Boot项目，可以使用Spring Initializr（Spring的项目初始化器）在线创建项目。访问Spring Initializr官网，选择Java版本和Spring Boot版本，添加项目依赖，下载项目后解压并导入到IDE中。例如，使用IDEA导入项目：

mvn clean install
idea .

使用Spring Initializr创建项目

使用Spring Initializr创建一个新项目，选择适当的项目结构、Java版本和Spring Boot版本，添加以下依赖：

• Spring Web
• Spring Boot Actuator
• Spring Cloud Gateway
• Nacos Discovery

在创建项目的过程中，选择依赖会自动生成pom.xml（对于Maven项目）或build.gradle（对于Gradle项目）文件。确保包含以下依赖：

<!-- Spring Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- Spring Boot Actuator -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

<!-- Spring Cloud Gateway -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

<!-- Nacos Discovery -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2021.1</version>
</dependency>

添加Gateway与Nacos依赖

确保项目中已添加Spring Cloud Gateway和Nacos Discovery的相关依赖。在pom.xml中添加：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2021.1</version>
</dependency>

在配置文件application.properties中添加Nacos的相关配置：

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
spring.application.name=example-gateway

Gateway路由配置

在Spring Boot应用中，为Gateway配置路由规则。在应用主类中添加@EnableDiscoveryClient以启用服务发现功能，并在配置文件中定义路由规则：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {

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

    @Bean
    public RouteLocator myRoutes(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("path_route", r -> r.path("/get")
                        .uri("http://httpbin.org"))
                .route("rewrite_route", r -> r.path("/post")
                        .filters(f -> f.rewritePath("/post11", "/post"))
                        .uri("http://httpbin.org"))
                .build();
    }
}

路由配置说明：

• path_route：定义一个路由，当请求的路径为/get时，将请求转发到http://httpbin.org。
• rewrite_route：定义一个路由，当请求的路径为/post时，将路径重写为/post11并转发到http://httpbin.org。

使用Nacos作为配置中心

将Nacos配置为Spring Boot应用的配置中心，可以实现配置的动态更新。在application.properties中添加Nacos配置：

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
spring.application.name=example-gateway
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.group=DEFAULT_GROUP
spring.cloud.nacos.config.namespace=public

在Nacos控制台上，添加配置信息，例如：

server.port=8080
spring.profiles.active=dev

启动Nacos服务

确保Nacos服务已经启动，可以通过浏览器访问http://localhost:8848/nacos，使用默认账号nacos/nacos登录。

启动Spring Boot应用

在IDE中运行GatewayApplication主类，应用启动后会自动注册到Nacos服务发现中。

访问测试接口

启动完成后，可以通过浏览器访问以下URL：

• 访问http://localhost:8080/get，将请求转发到http://httpbin.org/get。
• 访问http://localhost:8080/post，路径将被重写为/post11并转发到http://httpbin.org/post。

Gateway配置错误排查

1. 路由路径匹配失败：检查application.properties中的路由配置是否正确，确保路径与实际请求路径一致。
2. 服务未注册：确保application.properties中包含正确的服务注册信息，如spring.cloud.nacos.discovery.server-addr。
3. 服务未启动：确保目标服务已经启动并运行。

Nacos连接失败处理

1. Nacos服务未启动：确保已经启动Nacos服务，可以通过访问http://localhost:8848/nacos来检查服务是否正常运行。
2. 配置错误：检查application.properties中的Nacos配置是否正确，如spring.cloud.nacos.discovery.server-addr和spring.cloud.nacos.config.server-addr。
3. 网络问题：确保机器之间网络通信正常，可以尝试ping命令检查网络连通性。