概述
「完善项目架构」这个专题到此收尾。这一组内容做的其实是一件事:给项目工程补上统一接入层,用 Spring Cloud Gateway 挡住所有入口(路由转发 + 统一鉴权 + CORS),用 Nacos 配置中心接管那些「会变」的配置,最终形成 App / Vue → 网关 → 应用服务 → Dubbo 域服务 的完整分层。这里不重复前面几篇的细节,只做三件事:回顾分工、提炼可复用的模式、汇总踩过的坑。
纲要
- 这组内容做了什么:统一接入层的完整链路
- 五篇分工回顾:一篇一句话,方便回查
- 可复用模式提炼:新服务上线只需加路由、鉴权上移的边界、配置中心管什么
- 演进收益表:改造前的问题 vs 改造后的状态
- 坑位汇总:六个高频翻车点
- 练习建议:限流、访问日志、白名单前缀匹配
一句话概括:把「入口」从散落各处收拢成一个门。
改造之前,客户端直连各个应用服务,鉴权逻辑在每个服务里各写一遍,跨域配置同样要每个服务配一次,路由地址硬编码在调用方。改造之后,网关成为唯一入口,请求链路变成这样:
网关启动时从 Nacos 注册中心拉取各服务实例地址(路由用 lb://服务名 写法),从配置中心拉取路由表、CORS 规则和鉴权白名单。客户端请求到达网关后,先过 AuthFilter 校验 token(白名单接口直接放行),再按路由规则转发到对应服务。应用服务内部再通过 Dubbo 调用各域服务,这就是完整的四层结构。
工程实码的落点在 mf-gateway 模块,结构很薄,只有一个启动类、一个全局过滤器、一个 CORS 配置类:
mf-gateway
├── pom.xml
└── src/main
├── java/com/mf/gateway
│ ├── GatewayApplication.java # 启动类
│ ├── config/CorsConfig.java # 跨域 CorsWebFilter
│ └── filters/AuthFilter.java # 全局鉴权过滤器
└── resources/bootstrap.yml # 引导配置:连 Nacos
五篇分工回顾
| 篇目 | 解决的问题 | 关键产出 |
|---|---|---|
| 架构问题分析 | 直连服务导致的鉴权散落、地址硬编码、跨域重复配置 | 问题清单,引出统一接入层 |
| 网关的概述 | 网关是什么、为什么需要 | Gateway 的定位与核心概念(路由、断言、过滤器) |
| 搭建网关工程 | 网关模块怎么建、路由怎么配 | mf-gateway 模块 + /app、/admin 两条路由 |
| 统一鉴权思路与代码实现 | token 校验上移到网关 | AuthFilter 全局过滤器 + 白名单放行 |
| 配置中心 | 路由、白名单等配置动态管理 | bootstrap.yml + Nacos dataId 约定 |
细节都在各自篇目里,下面直接进提炼。
可复用模式提炼
模式一:统一接入层的标准配置
一套网关 = 四件事:路由 + 鉴权过滤器 + CORS + 白名单配置化。其中「配置化」最容易被忽略但收益最大,白名单不写死在过滤器里,而是放在 Nacos 的配置项 gateway.excludedUrls 中,通过 @Value 注入:
@Value("${gateway.excludedUrls}")
private List<String> excludedUrls; // 需要放行、不做 token 校验的路径
这套配置搭好之后,新上一个应用服务,网关侧只需要加一条路由(id + lb://服务名 + Path 断言 + StripPrefix),鉴权和 CORS 天然继承,不需要动任何 Java 代码。这是网关模式最实在的收益:接入成本从「改多个服务」降到「加一条配置」。
模式二:鉴权上移的边界
网关统一鉴权不等于「网关把安全全包了」。这一版的分工是:
| 层 | 负责什么 | 不负责什么 |
|---|---|---|
网关 AuthFilter | token 有效性校验(签名、过期),无效直接 401 拦截 | 不解析用户身份、不做细粒度权限 |
| 应用服务 | 从 token 解析出 userId,做业务级权限控制 | 不再重复做「token 是否有效」的基础校验 |
这是一个纵深防御的取舍:网关拦住绝大多数非法请求,降低后端压力;但服务端仍保留身份解析能力,不能假设「请求过了网关就一定可信」(内网调用、直连端口等场景依然存在)。实践中 AuthFilter 校验通过后可以把解析出的用户信息放进请求头再转发,服务端就不用再解一次 JWT;本版实现没做这一步,属于可以优化的点。
模式三:配置中心管什么
Nacos 配置中心不是「把 application.yml 整个搬上去」。判断一个配置该不该上配置中心,三条标准:
- 环境相关:数据库地址、Redis 地址,dev/test/prod 各不相同
- 会变的:路由表、鉴权白名单,改完不想重启网关
- 多服务共享:多个服务用同一份公共配置
反过来,那些纯代码逻辑相关的常量(比如某个固定超时值的默认语义)留在本地 yml 更合适。不要把所有配置都推上去,否则配置中心和 Git 都成了事实来源,谁对谁错说不清。
bootstrap.yml 里只保留「找到配置中心所需的最小信息」:应用名、profile、Nacos 地址、dataId 的 file-extension。查找规则是 spring.application.name + profile + file-extension,比如 mf-gateway-dev.yml,dataId 一旦定好,多环境就是加 profile 的事。
演进收益表
呼应架构问题分析里的那张问题表,逐项看改造后的状态:
| 改造前的问题 | 改造后的状态 |
|---|---|
| 鉴权代码在每个应用服务重复实现 | 网关 AuthFilter 一处实现,白名单配置化 |
| 客户端硬编码各服务地址 | 统一访问网关端口,路由按 Path 分发 |
| 服务实例变化需要改调用方配置 | lb://服务名 + Nacos 服务发现自动寻址 |
| 跨域配置每个服务各配一份 | 网关 CorsWebFilter 一处配置全局生效 |
| 改配置需要改代码、重新打包重启 | Nacos 配置中心动态下发,热更新 |
| 各服务直接暴露端口,攻击面大 | 只暴露网关,后端服务收在内网 |
坑位汇总
五篇里踩过的坑集中在这里,排查时按这张表对号入座:
| 坑 | 现象 | 原因与解法 |
|---|---|---|
| starter-web 冲突 | 网关启动报 Spring MVC found on classpath 类错误 | Gateway 基于 WebFlux,pom 里不能混入 spring-boot-starter-web |
| StripPrefix 忘配 | 服务收到 /app/user/login 全路径,接口 404 | 请求按 /app/** 进来,服务端映射是 /user/login,路由上必须配 StripPrefix=1 剥掉第一段 |
| 白名单漏配/精确匹配局限 | 登录接口也被 401 拦截,或带路径参数的免鉴权接口匹配不上 | 先补全 excludedUrls 里的登录、验证码路径;contains 是全等匹配,/user/123 匹配不上 /user/login,见文末练习 |
| 响应式写响应出错 | 401 响应体乱码或 Content-Type 异常 | Gateway 是响应式栈,不能拿 Servlet 的 response.getWriter() 用;必须用 DataBuffer + writeWith(Mono.just(buffer)),并显式设 Content-Type: application/json;charset=UTF-8 |
| bootstrap.yml 不生效 | Nacos 配置怎么都拉不到 | 配置中心连接信息必须写在 bootstrap.yml(加载先于 application.yml),且依赖里要有 spring-cloud-starter-alibaba-nacos-config |
| 动态刷新不生效 | 改了 Nacos 配置,网关行为没变 | 先确认 dataId 与查找规则匹配、profile 对得上;@Value 注入的配置刷新依赖配置类上加 @RefreshScope(路由等 Gateway 自身配置会自动刷新) |
常见误解澄清
| 误解 | 澄清 |
|---|---|
| 「网关统一鉴权后,服务端就不用管安全了」 | 网关只挡 token 有效性;身份解析、业务权限仍在服务端,这是纵深防御,不是单点防线 |
| 「配置中心 = 把整个 application.yml 搬上去」 | 只放环境相关、会变、共享的配置;本地留最小引导信息(bootstrap.yml) |
| 「白名单放网关配置里就一劳永逸」 | 精确匹配有局限,路径参数类接口需要前缀/通配匹配,且白名单本身是攻击面,要定期审 |
| 「CORS 配在网关就行,服务端完全不用管」 | 请求经过网关时 CORS 已处理,但如果存在绕过网关的直连调用,服务端仍需自行处理 |
| 「网关路由只能写死在 yml」 | 路由交给 Nacos 管理后动态可改,加服务不需要重启网关 |
练习建议
三项练习都是往已搭好的 mf-gateway 上加能力,每项都给改哪里、怎么验证:
1. 给网关加限流(Redis 令牌桶)
生产环境这一步不是可选项,没有限流的网关,一个突发流量就能把后端打穿。Gateway 自带 RequestRateLimiter 过滤器,底层就是 Redis + 令牌桶:
spring:
cloud:
gateway:
routes:
- id: mf-app-server
uri: lb://mf-app-server
predicates:
- Path=/app/**
filters:
- StripPrefix= 1
- name: RequestRateLimiter
args:
redis-rate-limiter.replenishRate: 10 # 每秒补充令牌数
redis-rate-limiter.burstCapacity: 20 # 桶容量
key-resolver: "#{@ipKeyResolver}" # 按 IP 限流
配套定义一个 KeyResolver Bean,按请求 IP 生成限流 key,网关的 pom 里加 spring-boot-starter-data-redis-reactive。验证:用 ab -n 1000 -c 50 或 JMeter 压测,观察超出阈值后返回 429 Too Many Requests。
2. 网关访问日志
在 AuthFilter 里(或单独写一个更高优先级的 GlobalFilter)统一记录:请求路径、来源 IP、token 是否有效、路由到的目标服务、耗时。响应式栈下耗时统计用 exchange.getAttributes() 存入开始时间戳,在 then() 回调里计算差值。验证:任意请求打一圈,控制台按序输出结构化日志。
3. 白名单改前缀匹配
把 excludedUrls.contains(path) 改成前缀匹配(如 excludedUrls.stream().anyMatch(path::startsWith)),并把白名单挪到 Nacos 配置里验证动态生效。验证:访问 /user/loginVerification 放行正常,同时确认 /user/loginXxx 这类意外前缀不会被误放,如果会,就换成 Ant 风格的路径匹配器做精确规则。
总结
这一组内容收拢后,项目工程的架构成型了:入口收敛到网关,鉴权一处实现,配置动态下发,服务按需水平扩展。回顾下来三条最值得带走的经验:
- 统一接入层的价值在「接入成本」:新服务上线只加一条路由,这是衡量网关搭没搭好的标准
- 鉴权上移要划清边界:网关管有效性、服务管身份解析,两层各司其职
- 配置中心要克制:只放会变、环境相关、共享的配置,别把 yml 整个搬上去
到这里,「完善项目架构」系列正式收官。后续还有后台管理系统:概述与搭建后台环境以及管理员登录、用户管理等篇目,继续走管理端这条线;再往后进入「数据统计与内容审核」,用户冻结解冻、日志采集、定时统计和内容审核,那是对这套架构下业务能力的延伸。
1839



被折叠的 条评论
为什么被折叠?



