在使用 Spring Cloud Gateway
+ Nacos + Sentinel 的组合时，通常是为了构建一个具备**服务发现（
Nacos）**、**API 网关路由（Gateway）** 和 **流量控制/熔断降级（
Sentinel）** 能力的微服务架构。以下是该技术栈集成的核心实现方式、常见问题及解决方案。
---
### ✅ 一、功能角色说明
| 组件 | 作用 |
|------|------|
| **
Nacos** | 作为注册中心和服务配置中心，管理微服务的注册与发现，以及动态配置 |
| **Spring Cloud Gateway** | 作为统一入口网关，负责请求路由、过滤、限流等 |
| **
Sentinel** | 提供流量控制、熔断降级、系统自适应保护等功能，保障系统稳定性 |
---
### ✅ 二、集成步骤详解
#### 1. 添加依赖（Maven）
```xml
<dependencies>
<!-- 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>
</dependency>
<!--
Sentinel for Gateway Flow Control -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-
sentinel</artifactId>
</dependency>
<!--
Sentinel Gateway Adapter -->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>
sentinel-reactor-adapter</artifactId>
<version>1.8.6</version> <!-- 根据 Spring Cloud Alibaba 版本匹配 -->
</dependency>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>
sentinel-spring-cloud-gateway-adapter</artifactId>
<version>1.8.6</version>
</dependency>
<!-- WebFlux required by Gateway -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
</dependencies>
```
> ⚠️ 注意版本兼容性！推荐使用如下组合：
>
> - Spring Boot 2.7.x
> - Spring Cloud 2021.0.x
> - Spring Cloud Alibaba 2021.0.5.0
> -
Sentinel 1.8.6
---
#### 2. 配置文件 `application.yml`
```yaml
server:
port: 9000
servlet:
context-path: /
spring:
application:
name: api-gateway
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848 #
Nacos 服务地址
config:
server-addr: ${spring.cloud.
nacos.discovery.server-addr}
file-extension: yaml
gateway:
discovery:
locator:
enabled: true # 开启自动根据注册中心服务名路由
routes:
- id: user-service-route
uri: lb://user-service # 使用负载均衡访问 user-service
predicates:
- Path=/api/users/**
filters:
- StripPrefix=1
sentinel:
transport:
dashboard: 127.0.0.1:8080 #
Sentinel 控制台地址
eager: true # 立即初始化
Sentinel
```
---
#### 3. 启用
Sentinel 对 Gateway 的支持（Java 配置类）
```java
import com.alibaba.csp.
sentinel.adapter.gateway.common.rule.GatewayFlowRule;
import com.alibaba.csp.
sentinel.adapter.gateway.common.rule.RuleConstant;
import com.alibaba.csp.
sentinel.adapter.gateway.sc.
SentinelGatewayFilter;
import com.alibaba.csp.
sentinel.adapter.gateway.sc.callback.BlockRequestHandler;
import com.alibaba.csp.
sentinel.adapter.gateway.sc.callback.GatewayCallbackManager;
import com.alibaba.csp.
sentinel.adapter.gateway.sc.exception.
SentinelGatewayBlockExceptionHandler;
import org.springframework.beans.factory.ObjectProvider;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.http.HttpStatus;
import org.springframework.web.reactive.function.server.ServerResponse;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;
import javax.annotation.PostConstruct;
import java.util.HashSet;
import java.util.Set;
@Configuration
public class GatewayConfiguration {
private final Set<GatewayFlowRule> rules = new HashSet<>();
@PostConstruct
public void init() {
// 定义针对 route 或 API 分组的限流规则
rules.add(new GatewayFlowRule("user-service-route") // 路由 ID
.setCount(10) // 每秒最多 10 个请求
.setIntervalSec(1) // 统计间隔：1 秒
.setGrade(RuleConstant.FLOW_GRADE_QPS) // 限流维度：QPS
);
// 可以添加基于 API 分组的规则
rules.add(new GatewayFlowRule("api_users")
.setCount(20)
.setIntervalSec(1)
.setGrade(RuleConstant.FLOW_GRADE_QPS)
);
}
@Bean
@Order(Ordered.HIGHEST_PRECEDENCE)
public
SentinelGatewayBlockExceptionHandler
sentinelGatewayBlockExceptionHandler() {
return new
SentinelGatewayBlockExceptionHandler();
}
@Bean
@Order(-1)
public GlobalFilter
sentinelGatewayFilter() {
return new
SentinelGatewayFilter();
}
/**
* 自定义被限流后的返回内容
*/
@PostConstruct
public void setBlockHandler() {
BlockRequestHandler blockRequestHandler = (exchange, t) -> {
exchange.getResponse().setStatusCode(HttpStatus.TOO_MANY_REQUESTS);
String msg = "{\"code\":429,\"message\":\"请求过于频繁，请稍后再试\"}";
byte[] bytes = msg.getBytes(org.springframework.util.Charset.forName("UTF-8"));
DataBuffer buffer = exchange.getResponse().bufferFactory().wrap(bytes);
return exchange.getResponse().writeWith(Mono.just(buffer));
};
GatewayCallbackManager.setBlockHandler(blockRequestHandler);
}
}
```
---
#### 4. 启动
Nacos 和
Sentinel Dashboard
- 启动
Nacos Server：
```bash
sh bin/startup.sh -m standalone
```
- 启动
Sentinel Dashboard：
```bash
java -jar
sentinel-dashboard-1.8.6.jar
```
访问：http://localhost:8080，登录账号密码默认 `
sentinel/
sentinel`
- 在你的微服务和网关中配置 `-Dcsp.
sentinel.app.type=1` 表示是网关应用（可选）
---
### ✅
三、
Sentinel 控制台查看网关监控
启动后访问任意接口触发流量，然后打开
Sentinel 控制台：
- 在“簇点链路”中可以看到 `/api/users/**` 这样的网关路由资源
- 点击“
+ 流控”按钮，可以为某个 API 或路由设置 QPS 限制
- 支持按调用来源（origin）进行黑白名单控制
---
### ✅ 四、常见问题与解决
#### ❌ 问题1：
Sentinel 控制台看不到网关的 API 资源？
**原因**：未正确引入 `
sentinel-spring-cloud-gateway-adapter` 或未触发请求。
**解决**：
- 确保已引入
适配器依赖
- 发起真实请求触发资源注册
- 检查日志是否连接到
Sentinel 控制台成功
#### ❌ 问题2：网关限流不生效？
**原因**：缺少 `@Bean
SentinelGatewayFilter` 或异常处理器未注册。
**解决**：确保配置类中注册了 `
SentinelGatewayFilter` 和 `
SentinelGatewayBlockExceptionHandler`
#### ❌ 问题3：如何基于用户 IP 限流？
**方案**：可以通过自定义 `OriginParser` 实现：
```java
@PostConstruct
public void initOriginParser() {
GatewayCallbackManager.setOriginParser(exchange -> {
String remoteAddress = exchange.getRequest().getRemoteAddress().getAddress().getHostAddress();
return remoteAddress; // 使用 IP 作为 origin
});
}
```
然后在
Sentinel 控制台配置“流控应用”字段为特定 IP 即可实现按 IP 限流。
---
### ✅ 五、优势总结
| 功能 | 实现方式 |
|------|----------|
| 动态路由 |
Nacos 注册中心自动发现服务 |
| 流量治理 |
Sentinel 提供实时 QPS 限流、熔断 |
| 可视化控制 |
Sentinel Dashboard 图形化操作 |
| 高可用 | Gateway 支持负载均衡
+ 断路器 |
---
本文介绍了如何将Nacos、Sentinel和Dubbo整合在一起，首先进行了父工程和接口工程的改造，创建了dubbo服务接口工程。接着改造了提供者工程，引入了Spring Cloud和Dubbo的依赖，将原有的接口替换为Dubbo服务接口，并配置了dubbo的相关设置，成功在Nacos中注册服务。最后改造了服务消费者工程，移除了Feign和Ribbon的相关内容，添加了Dubbo的配置，实现了服务的消费。改造完成后，两个工程都在Nacos控制台完成了服务注册。
最低0.47元/天 解锁文章
扫一扫
1056
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
