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

评估版本: QuickBlue v4.0.0 (PostgreSQL 版)
评估工具: Qoder 架构分析引擎
评估日期: 2026-03-29

一、架构全景概览

1.1 系统架构拓扑

┌─────────────────────────────────────────────────────────────────────┐
│                        前端层 (Vue 3 + Ant Design Vue)              │
│                       QuickBule-admin-webpg                        │
└───────────────────────────┬─────────────────────────────────────────┘
                            │ HTTP / WebSocket
┌───────────────────────────▼─────────────────────────────────────────┐
│              API 网关层  (Spring Cloud Gateway)                     │
│              QuickBlue-gateway   :8080                              │
│   ┌─────────────┬──────────────┬──────────────┬──────────────┐     │
│   │ AuthFilter  │ GlobalLog    │ RequestHeader│ OpenApiFilter│     │
│   │  + 白名单   │  + 慢请求告警│  + 链路追踪  │  + API聚合   │     │
│   └─────────────┴──────────────┴──────────────┴──────────────┘     │
└──┬───────────┬──────────────┬──────────────┬───────────────────────┘
   │           │              │              │
   ▼           ▼              ▼              ▼
┌──────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│System│  │ Business  │  │ Support  │  │   AI     │  │  Admin   │
│:8081 │  │  :8082    │  │  :8083   │  │  :8084   │  │  :9090   │
│ 系统 │  │  业务     │  │  支撑    │  │  智能    │  │  监控    │
│ 管理 │  │  管理     │  │  服务    │  │  服务    │  │  中心    │
└──┬───┘  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────────┘
   │           │              │              │
   ▼           ▼              ▼              ▼
┌──────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│  DB  │  │   DB     │  │   DB     │  │ DB+Vector│
│system│  │ business │  │ support  │  │   ai     │
└──────┘  └──────────┘  └──────────┘  └──────────┘
                ↕ (OpenFeign + OkHttp)
┌─────────────────────────────────────────────────────────────────────┐
│  基础设施层: Nacos(注册/配置) | Redis/Redisson | Sentinel | SBA    │
└─────────────────────────────────────────────────────────────────────┘

1.2 模块矩阵

二、核心评估维度

2.1 服务独立性评估

评分：7.5 / 10 ⭐⭐⭐⭐

2.1.1 优势

2.1.2 风险与不足

2.1.3 改进建议

1. 按需引入 common 模块：business 服务不需要 excel 模块，应移除不必要依赖

2. 拆分 common-core：将 mybatis-plus-extension、sa-token-core 从 core 中分离，网关只需轻量 core

3. 统一 JSON 库：移除 fastjson，仅保留 fastjson2（已在 BOM 中管理）

4. 引入独立版本号管理：各服务模块可独立定义 version，通过 BOM 管理兼容性

2.2 耦合度评估

评分：7.0 / 10 ⭐⭐⭐⭐

2.2.1 服务间通信拓扑（Feign 调用链）

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

2.2.2 耦合分析

2.2.3 common 模块依赖关系

xxxxxxxxxx
common-core ◀──── 所有模块的基础
    ▲
    │
common-web ◀──── common-redis (redis 依赖 web 的 RepeatSubmit)
    ▲
    │
common-security ──▶ common-redis
    ▲
    │
common-database ──▶ common-core
common-swagger  ──▶ common-core
common-log      ──  独立
common-excel    ──  独立

问题：common-redis 反向依赖 common-web（为了防重复提交功能），造成层次混乱。Redis 应为底层基础设施，不应依赖 Web 层。

2.2.4 改进建议

1. 全面补齐 Feign Fallback：为所有 FeignClient 提供降级实现，避免级联故障

2. 解耦 redis→web 依赖：将防重复提交的抽象接口移至 core 或独立模块

3. 引入事件驱动：日志记录、消息通知等场景可用 RocketMQ（已在 BOM 中声明但未使用）异步解耦

4. DTO 版本兼容：考虑在 DTO 中使用 @JsonIgnoreProperties(ignoreUnknown = true) 增强前后兼容性

2.3 数据隔离评估

评分：8.5 / 10 ⭐⭐⭐⭐⭐

2.3.1 数据库隔离策略

2.3.2 隔离评估

2.3.3 表设计规范分析

2.3.4 改进建议

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

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

3. 统一主键策略：建议统一为雪花算法（id-type: assign_id），既有序又分布式友好

4. 统一表命名规范：建议 qb_模块_表名 格式（如 qb_sys_employee, qb_ai_app）

2.4 扩展性评估

评分：8.0 / 10 ⭐⭐⭐⭐

2.4.1 水平扩展能力

2.4.2 垂直扩展能力

2.4.3 弹性治理能力

2.4.4 改进建议

1. 落地 Sentinel 规则：为核心接口配置限流/降级规则，通过 Nacos 持久化

2. 引入 Micrometer Tracing：替换已废弃的 Sleuth，实现分布式链路追踪

3. RocketMQ 异步化：日志写入、文件处理、AI知识库索引等场景异步化

4. 容器化就绪：添加 Dockerfile 和 Kubernetes 部署描述符

2.5 可维护性评估

评分：7.5 / 10 ⭐⭐⭐⭐

2.5.1 代码组织

2.5.2 配置管理

2.5.3 监控可观测性

2.5.4 安全合规

2.5.5 改进建议

1. 完善网关 Token 验证：取消 AuthenticationFilter 中的注释代码，接入 Sa-Token 或 JWT 验证

2. 敏感信息外置：使用环境变量或 Vault 管理密码，从代码仓库中移除明文密码

3. 多环境配置：补全 test/staging/prod 环境的 Nacos 命名空间和配置

4. 引入分布式追踪：集成 Micrometer Tracing + Zipkin/Jaeger

2.6 技术栈先进性评估

评分：9.0 / 10 ⭐⭐⭐⭐⭐

2.6.1 核心技术栈版本矩阵

2.6.2 技术选型评价

2.6.3 技术风险

三、架构评分总结

3.1 雷达图评分

xxxxxxxxxx
                    技术栈先进性
                       9.0
                        │
              ┌─────────┼─────────┐
              │         │         │
   可维护性 7.5 ────────┼──────── 8.5 数据隔离
              │         │         │
              │         │         │
              └─────────┼─────────┘
                        │
    耦合度 7.0 ─────────┼───────── 8.0 扩展性
                        │
                   服务独立性
                      7.5

3.2 综合评分

3.3 架构成熟度定级

当前等级：L3 — 规范级（接近 L4 可管理级）

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

4.1 紧急修复（P0 — 1-2 周）

4.2 短期优化（P1 — 1-2 月）

4.3 中期增强（P2 — 3-6 月）

五、架构亮点与总结

5.1 核心亮点

1. 技术栈极度前沿：Java 21 + Spring Boot 3.5 + Spring Cloud 2025.0 + Spring Cloud Alibaba 2025.0，处于 Java 微服务技术栈的最前沿

2. AI 能力内建：LangChain4j + pgvector + LiteFlow 流程引擎，将 AI/RAG 能力作为微服务原生能力内建，架构前瞻性极强

3. 数据库选型正确：PostgreSQL + pgvector 一体化方案，既满足关系型数据需求，又原生支持向量检索，减少运维复杂度

4. 安全合规齐全：三级等保配置模块化、Argon2id 密码哈希、SM4 国密支持、数据权限多级控制

5. API 文档一体化：Knife4j + SpringDoc 网关聚合，开发体验友好

6. 多级缓存设计：Caffeine(L1) + Redis(L2) + Redisson(分布式锁)，缓存架构成熟

7. OpenFeign + OkHttp 高性能通信：连接池复用、GZIP 压缩、细粒度超时控制

5.2 总体评价

QuickBlue v4.0.0 是一个技术栈极其前沿、架构分层清晰、AI 能力前瞻的微服务框架。核心架构设计（服务拆分、数据隔离、配置管理、安全体系）达到了企业级应用的生产标准。主要改进空间集中在治理能力落地（Sentinel/链路追踪实际启用）和代码级工程规范（版本冲突、common 模块瘦身、Feign 降级补齐）两个方向。在完成 P0/P1 阶段改进后，该架构可从 L3 规范级顺利晋升至 L4 可管理级，具备支撑大规模生产部署的能力。