QuickBlue 微服务架构评估报告 v9.0

评估版本: QuickBlue v4.0.0 (PostgreSQL 版)
评估工具: 全量代码仓库扫描 + 静态分析
评估日期: 2026-06-27
评估角色: 专家团架构师(含架构设计师、安全专家、DBA、DevOps 专家、前端架构师)

版本更新说明 (v8.0 → v9.0)

重大变更

v8.0 P0 紧急修复项完成度

一、架构全景概览

1.1 系统架构拓扑

┌─────────────────────────────────────────────────────────────────────┐
│                        前端层 (Vue 3 + Ant Design Vue)              │
│                       QuickBule-admin-webpg                        │
│                  Vite 5.2 + Pinia + Vue Router 4                   │
└───────────────────────────┬─────────────────────────────────────────┘
                            │ HTTP / WebSocket
┌───────────────────────────▼─────────────────────────────────────────┐
│              API 网关层  (Spring Cloud Gateway)                     │
│              QuickBlue-gateway   :8080                              │
│   ┌─────────────┬──────────────┬──────────────┬──────────────┐     │
│   │ AuthFilter  │ GlobalLog    │ RequestHeader│ OpenApiFilter│     │
│   │ + Redis验证 │ + 慢请求告警 │ + 链路追踪   │ + API聚合    │     │
│   └─────────────┴──────────────┴──────────────┴──────────────┘     │
└──┬───────────┬──────────────┬──────────────┬───────────────────────┘
   │           │              │              │
   ▼           ▼              ▼              ▼
┌──────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│System│  │ Business  │  │ Support  │  │   AI     │  │  Admin   │
│:8081 │  │  :8082    │  │  :8083   │  │  :8084   │  │  :9090   │
│ 系统 │  │  业务     │  │  支撑    │  │  智能    │  │  监控    │
│ 管理 │  │  管理     │  │  服务    │  │  服务    │  │  中心    │
└──┬───┘  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────────┘
   │           │              │              │
   │    ┌──────┼──────────────┼──────────────┤
   │    │      │    雪花算法统一主键生成       │
   │    │   IdType.ASSIGN_ID (MyBatis-Plus)  │
   │    │   + SnowflakeIdentifierGenerator   │ 🆕 自定义(支持K8s)
   │    └──────┼──────────────────────────────┘
   ▼           ▼              ▼              ▼
┌──────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│  DB  │  │   DB     │  │   DB     │  │ DB+Vector│
│system│  │ business │  │ support  │  │   ai     │
│PG18.3│  │ PG18.3   │  │ PG18.3   │  │PG18.3+pgv│
└──────┘  └──────────┘  └──────────┘  └──────────┘
                ↕ (OpenFeign + OkHttp + 🆕 Fallback 全覆盖)
┌─────────────────────────────────────────────────────────────────────┐
│  基础设施层: Nacos 2.4.3 | Redis/Redisson | Sentinel | SBA | Zipkin│
└─────────────────────────────────────────────────────────────────────┘

1.2 模块矩阵与 Java 源文件统计

1.3 核心技术栈版本矩阵

二、核心评估维度

2.1 服务独立性评估

评分: 9.0 / 10 ⭐⭐⭐⭐⭐ (v8.0: 8.0 → v9.0: 9.0 ↑ +1.0)

2.1.1 v8.0→v9.0 改进

2.1.2 优势

2.1.3 风险与不足

2.2 耦合度评估

评分: 8.5 / 10 ⭐⭐⭐⭐ (v8.0: 7.5 → v9.0: 8.5 ↑ +1.0)

2.2.1 服务间通信拓扑

xxxxxxxxxx
                    ┌──────────────┐
           ┌───────▶│ api-system   │◀──── system 自身实现
           │        │ 6 FeignClient│       (LoginFeign, DeptFeign,
           │        │ 6 Fallback ✅│        EmployeeFeign, MenuFeign,
           │        └──────────────┘        RoleFeign, OperateLogFeign)
           │
  ┌────────┼────────┐
  │ system │business │ support      ai
  │        │        │
  │        │   ┌────▼──────────┐
  │        ├──▶│ api-support   │◀──── support 自身实现
  │        │   │ 9 FeignClient │       (FileStorage, Captcha,
  │        │   │ 9 Fallback ✅ │        LoginLog, OperateLog,
  │        │   └───────────────┘        QRCode, Message, ApiEncrypt,
  │        │                            Level3ProtectConfig)
  │        │
  │        ├──▶ api-business (2 FeignClient + 2 Fallback ✅)
  │        │
  └────────┼──▶ api-ai (3 FeignClient + 3 Fallback ✅)
           │
           └──▶ system → api-support (跨服务调用)
               business → api-system + api-support (跨服务调用)
               ai → api-system (跨服务调用)

2.2.2 耦合分析

2.2.3 common 模块依赖关系

​x
L0: common-core ◀────────── 所有模块的基础（抽象层）

L1: common-web          ← 依赖 core
    common-redis        ← 只依赖 core（注：不依赖 web！）
    common-swagger      ← 依赖 core
    common-excel        ← 依赖 core

L2: common-database     ← 依赖 core + web
    common-log          ← 依赖 core + web

L3: common-security     ← 依赖 core + redis

┌──────────────────────────────────────────────────────┐
│   防重复提交 — 策略模式解耦（redis 与 web 零直接依赖）        │
│                                                      │
│   common-core:  AbstractRepeatSubmitTicket (抽象)     │
│        ↙ ↘                                          │
│   redis          web                                │
│   └─ RedisImpl   └─ MemoryImpl + AOP 切面             │
│   (@ConditionalOnMissingBean 自动切换)                │
└──────────────────────────────────────────────────────┘

设计评价: common 模块依赖层次清晰(L0→L3 共 4 级)，common-redis 与 common-web 通过 common-core 的 AbstractRepeatSubmitTicket 抽象实现解耦，采用策略模式 + Spring 条件注入，无反向依赖。

2.3 数据隔离评估

评分: 9.5 / 10 ⭐⭐⭐⭐⭐ (v8.0: 9.5 → 持平)

2.3.1 数据库隔离策略

2.3.2 隔离评估

2.3.3 表设计规范分析

2.3.4 改进建议

1. 生产环境每库独立账号: 限制最小权限，杜绝跨库操作

2. 密码加密存储: Nacos 配置启用 Jasypt 加密或 Vault 密钥管理

3. SM4 密钥外置: 🆕 将硬编码密钥移至环境变量

4. 统一表命名规范: 建议 qb_模块_表名 格式

2.4 扩展性评估

评分: 8.5 / 10 ⭐⭐⭐⭐ (v8.0: 8.5 → 持平)

2.4.1 水平扩展能力

2.4.2 垂直扩展能力

2.4.3 弹性治理能力

2.5 可维护性评估

评分: 9.5 / 10 ⭐⭐⭐⭐⭐ (v8.0: 9.0 → v9.0: 9.5 ↑ +0.5)

2.5.1 代码组织与工程质量

2.5.2 配置管理

2.5.3 监控可观测性

2.5.4 安全合规

2.6 测试与 DevOps 评估 (🆕 新增维度)

评分: 2.0 / 10 ⭐ (v8.0: 未评估)

2.6.1 测试覆盖

2.6.2 容器化与部署

2.6.3 文档与 API 文档

2.7 技术栈先进性评估

评分: 9.5 / 10 ⭐⭐⭐⭐⭐ (v8.0: 9.5 → 持平)

2.7.1 技术选型评价

2.7.2 技术风险

三、架构评分总结

3.1 雷达图评分

xxxxxxxxxx
                    技术栈先进性
                       9.5
                        │
              ┌─────────┼─────────┐
              │         │         │
   可维护性 9.5 ────────┼──────── 9.5 数据隔离
              │         │         │
              │         │         │
              └─────────┼─────────┘
                        │
    耦合度 8.5 ─────────┼───────── 8.5 扩展性
                        │
                   服务独立性
                      9.0
                        
              🆕 测试与DevOps: 2.0

3.2 综合评分

说明: 耦合度评分因数据耦合/common横切耦合降级而上调(8.0→8.5)，驱动综合得分微升。若排除「测试与DevOps」新增维度，核心架构得分从 8.92 提升至 9.03。

3.3 架构成熟度定级

当前等级: L4 — 可管理级 (v8.0: L4 → 维持)

维持 L4 说明:

• ✅ v8.0 P0 全部修复: AI/Region 实体类型迁移完成、SnowflakeIdentifierGenerator 落地

• ✅ 降级容错飞跃: Feign Fallback 覆盖率从 ~5% 提升至 100%

• ✅ Java 21 兼容修复: SmartBeanUtil、RegionCacheManager 不可变列表问题已解决

• ✅ 前端体验修复: 菜单手风琴模式类型一致性问题修复

• ⚠️ 熔断降级仍未落地: Sentinel 规则未配置

• ⚠️ 分布式事务未引入: Seata 声明但未使用

• 🔴 新发现安全风险: SM4 密钥硬编码、配置文件明文密码

• ❌ 容器化完全缺失: 项目中无任何 Docker/K8s 相关文件

• ❌ 测试覆盖率 < 1%: 750+ Java 文件，0 个有效测试

四、专家团优先改进路线图

4.1 紧急修复 (P0 — 立即执行)

4.2 短期优化 (P1 — 1-2 月)

4.3 中期增强 (P2 — 3-6 月)

4.4 长期演进 (P3 — 6-12 月)

五、架构亮点与总结

5.1 核心亮点

1. 技术栈极度前沿: Java 21 + Spring Boot 3.5 + Spring Cloud 2025.0 + Spring Cloud Alibaba 2025.0

2. AI 能力内建: LangChain4j + pgvector + LiteFlow 流程引擎，7+ LLM 提供商支持

3. 数据库选型正确: PostgreSQL 18.3 + pgvector 一体化方案

4. 安全合规齐全: 三级等保、Argon2id 密码哈希、SM4 国密、数据权限多级控制

5. 主键策略统一: 🆕 全模块雪花算法 + 自定义 SnowflakeIdentifierGenerator(支持 K8s)

6. 降级容错全覆盖: 🆕 20 个 FeignClient 100% Fallback 覆盖

7. P0 风险清零: 🆕 v8.0 标记的 AI/Region 实体类型迁移、雪花 WorkerId 全部完成

8. Java 21 兼容: 🆕 SmartBeanUtil、RegionCacheManager 不可变列表问题已修复

9. API 文档一体化: Knife4j + SpringDoc 网关聚合

10. 多级缓存设计: Caffeine(L1) + Redis(L2) + Redisson(分布式锁)

5.2 与 v8.0 对比总结

5.3 总体评价

QuickBlue v4.0.0 从 v8.0 到 v9.0 的核心演进是 P0 风险全面清零 + 降级容错能力质的飞跃。v8.0 报告标记的三项最高优先级风险——AI 实体类型迁移、Region 实体类型迁移、自定义雪花 WorkerId——已全部完成。Feign Fallback 覆盖率达到 100%，Java 21 兼容性问题得到修复，前端用户体验改善。

工程成熟度提升显著，但 v9.0 首次引入「测试与DevOps」评估维度后，暴露出两大短板：

• 🔴 安全风险: SM4 密钥硬编码、配置文件明文密码、CORS 不安全配置

• 🔴 工程化缺失: 测试覆盖率 < 1%、无容器化、无 CI/CD

当前综合得分(含新维度) 8.58，核心维度得分 8.92。架构成熟度维持 L4 可管理级。

v9.0 的优先任务已从"数据层修复"转向"安全加固 + 工程化建设"：

• 🔴 P0: SM4 密钥外置、配置文件密码清理、WallFilter 恢复、网关认证加固

• 🔴 P1: Sentinel 规则落地、CORS 加固、容器化改造、测试体系搭建、CI/CD 流水线

• 🟠 P2: RocketMQ 异步化、多环境配置、密码加密、表命名统一

完成 P0-P1 阶段改进后，该架构将从 L4 可管理级迈向 L5 优化级，具备支撑大规模安全合规生产部署的完整能力。

六、附录

6.1 评估范围

本报告基于以下代码和配置全量分析生成:

• ✅ POM 依赖树(父 POM + 22 个子模块)

• ✅ 源码结构(750+ Java 文件，涵盖 8 个 common 模块 + 4 个 api 模块 + 4 个业务模块 + 网关 + 监控)

• ✅ 数据库 DDL(database/postgresql + Flyway 迁移脚本 V1~V9)

• ✅ Nacos 配置(5 个共享配置 + 6 个服务私有配置)

• ✅ 网关过滤器链(5 个 GlobalFilter)

• ✅ API 通信拓扑(20 个 FeignClient + 20 个 Fallback)

• ✅ 前端技术栈(Vue 3.4 + Ant Design Vue 4.2 + Vite 5.2)

• ✅ 安全机制(Sa-Token、SM4、Argon2id、Druid WallFilter、三级等保)

• ✅ 技术文档(25 个 Markdown 文件)

• ✅ 🆕 SnowflakeIdentifierGenerator 实现

• ✅ 🆕 安全硬编码扫描(SM4 密钥、配置文件密码)

• ✅ 🆕 测试覆盖率分析

• ✅ 🆕 DevOps 就绪度评估

• ✅ 🆕 Manager 层手动 N+1 查询分析

6.2 v9.0 新增评估维度

6.3 v8.0→v9.0 变更清单

6.4 参考资料

• Spring Boot 3.5 官方文档

• Spring Cloud 2025.0 官方文档

• MyBatis-Plus 雪花算法

• Micrometer Tracing 官方文档

• Flyway 官方文档

• Sa-Token 官方文档

• LangChain4j 官方文档

• PostgreSQL 18 官方文档

• Argon2 密码哈希

v9.0 核心变更: v8.0 P0 风险全面清零(AI/Region 类型迁移、SnowflakeIdentifierGenerator)，Feign Fallback 确认 100% 覆盖，Java 21 兼容性问题修复，前端体验改善。新增测试/DevOps/安全深度评估维度，发现 SM4 密钥硬编码、测试缺失等新风险。

下次评估建议: 在完成 P0 安全加固和 P1 容器化+测试体系建设后(预计 2026-08)，进行 v10.0 评估，重点关注 Sentinel 规则落地、容器化改造进展、测试覆盖率、CI/CD 流水线建设。