Spring Boot 4.0.8 + Spring Cloud 2025.1.3 + Spring Cloud Alibaba 2025.1.0.0 + JDK 21 的多应用微服务工程。
统一身份域承载所有注册应用:应用之间以 system_id 收窄数据、以角色授权隔离权限,无租户维度。
| 能力 | 实现 |
|---|---|
| 统一身份 | 一套 system_user 覆盖全部注册应用(business_system);域在登录时声明一次 |
| 令牌 | auth-service 是唯一签发方:JWT 签发 / 续期 / 撤销 + JWK 分发,网关本地验签 |
| 会话 | 会话快照存 Redis;网关按令牌坐标还原一次并写入下游请求头,下游不回查认证中心 |
| 数据域 | ORM 统一处理:读改写 where、写归位实体域,DDL system_id NOT NULL 兜底 |
| 权限 | 角色 / 菜单 / 端点授权 + 角色继承,唯一入口 @CheckPerms |
| 日志 | 登录、操作日志由切面发布事件,经 RPC 汇入 user-infra 落库 |
| 验证码与风控 | proof-service 统一 /captcha 派发(图形 / 滑块 / 算力),换发风控通行票;网关按路径强制 |
| 灰度路由 | route-decision 策略(CLOSE / OPEN / FORCE)+ 实例元数据标签 + X-LB-Hint 透传 |
| 支付 | 渠道 SPI(微信 / 支付宝)、原子额度预留防超退、回调验签与幂等、商户通知 outbox |
| 横向组件 | 幂等、分布式锁、限流熔断、Excel、字段脱敏、告警通知 |
client → gateway :10001 ─┬─ 验签 → 查会话快照(auth /session/query)
├─ 注入 X-User-Context / X-Tracing-Id / X-LB-Hint
└─ 按路径前缀转发
- 下游仅从头还原上下文(
UserContextFilter),不产生额外 RPC - 头值是上下文 JSON 的 Base64(URL-safe)编码:HTTP 头只接受 ASCII,角色名、部门名等含中文无法直传
- 服务间 RPC 出站自动透传同一组头
远程调用:Spring 只认显式声明(官方入口 @ImportHttpServices),本项目用 @RpcScan(启动类声明扫描根)
@RpcClient(group, url)(接口自声明分组)替代,一个扫描根覆盖多服务接口,注册器在启动期校验分组与方法级 exchange 注解。寻址只由spring.http.serviceclient.<group>.base-url决定(lb://服务名走注册中心,http(s)://地址直连);该属性缺省时请求到运行期才失败,故启动期提前校验。
wzkris
├── sql/postgresql // user / payment / nacos 建库脚本
├── wzkris-bom // 版本清单
├── wzkris-common // 横切能力
│ ├── common-core // 模型、枚举、工具、异常
│ ├── common-orm // MyBatis-Plus 封装 + 数据域拦截器
│ ├── common-redis // Redis、幂等、分布式锁
│ ├── common-security // 身份上下文与 @CheckPerms
│ ├── common-web // 上下文过滤器、全局异常、Jackson、Facade 基类
│ ├── common-remote // HTTP Service Client 契约与拦截器
│ ├── common-loadbalancer // 灰度路由
│ ├── common-validator / excel / sentinel / notifier / weixin-sdk
├── wzkris-gateway :10001 // SCG WebMVC,唯一入口
├── wzkris-auth-service :9000 // 令牌、会话、JWK
├── wzkris-manage-agg :4000 // 管理端聚合与登录入口,不落库
├── wzkris-proof-service :9300 // 验证码与风控票,仅用 Redis
├── wzkris-modules-infra
│ ├── wzkris-user-infra :3031 // 用户、角色、部门、菜单、日志
│ └── wzkris-payment-infra :3032 // 下单、退款、余额、渠道配置
└── wzkris-extends
├── wzkris-monitor-admin :9100 // 应用监控
├── wzkris-mqtt-server :1883 // MQTT Broker
└── wzkris-track :9102 // 埋点采集
| 依赖 | 版本 | 用途 |
|---|---|---|
| JDK | 21 | 开发与运行 |
| Maven | 3.6+ | 构建 |
| PostgreSQL | 15+ | 业务库(schema biz)与 Nacos 配置库 |
| Redis | 8.0+ | 缓存、会话、锁 |
| Nacos | 3.x | 注册发现与配置(配置存 PostgreSQL,脚本 sql/postgresql/nacos.sql) |
# 1. 初始化:依次执行 user_db、payment_db、nacos.sql
# 2. 启动 Nacos 与 Redis,导入配置(命名空间 application-dev,分组 APPLICATION_GROUP / COMMON_GROUP)
# 3. 构建并启动(建议顺序)
mvn clean package -DskipTests
gateway(10001) → auth(9000) → proof(9300) → user-infra(3031) → payment-infra(3032) → manage-agg(4000)访问:网关 http://localhost:10001;接口文档 <context-path>/doc.html;监控中心 http://localhost:9100
| 场景 | 选择 | 备注 |
|---|---|---|
| 远程调用 | HttpServiceProxyFactory | 非 Feign;用 @RpcScan + @RpcClient 替代官方 @ImportHttpServices,接口自声明分组 |
| 网关 | Spring Cloud Gateway WebMVC | Servlet 栈,与业务服务同一套过滤器约定 |
| 对象映射 | BeanCopierUtil | 非 MapStruct |
| 序列化 | Jackson 3 | Long / BigDecimal 输出为字符串,避免前端精度丢失 |
| 认证 | Spring Security JWT (JOSE) | 自建签发与 JWK 分发,不引入 OAuth2 授权服务器 |
| 接口文档 | Knife4j | OpenAPI 3,按服务聚合 |
zlib License · 欢迎提交 Issue 与 Pull Request。