MateCloud 5.0.8 发布：从微服务脚手架迈向 AI 原生工程底座！

版本亮点

MateCloud 是一套 AI 原生、云原生的 DDD 微服务脚手架，基于 Spring Boot 4.0.7、Spring Cloud 2025.1.2、Spring Cloud Alibaba 2025.1.0.0、Dubbo 3.3.6、Spring AI 2.0、Java 21 构建，面向中后台、SaaS、多租户、微服务治理和 AI 工程集成场景。MateCloud 5.0.8 正式版发布，重点是把 MateCloud 从传统微服务脚手架推进到“AI 原生工程底座”。它既保留 Spring Cloud + Dubbo + Nacos 的微服务形态，也新增 `mate - monolith` 单体组合根，让同一套业务代码可以在单体和微服务之间切换；同时引入 Spring AI 2.0、`@Tool` 自动发现、MCP Server、CLI 工程工具和完整 Starter 体系，为 AI Agent 操作业务系统提供工程闭环。

技术栈升级

MateCloud 5.0.8 采用新一代 Java 后端技术栈，包括 Java 21、Spring Boot 4.0.7、Spring Cloud 2025.1.2、Spring Cloud Alibaba 2025.1.0.0、Dubbo 3.3.6、Spring AI 2.0.0、MyBatis Plus 3.5.16、Sa - Token 1.45.0、Redisson 4.5.0、Vue 3.5 + Element Plus + Vite。这意味着 MateCloud 不再只是“能跑的后台模板”，而是面向 2026 年 Java 云原生技术栈重新整理的一套工程基座。

单体/微服务双形态

5.0.8 新增并修复了 `mate - monolith` 单体模式，使 MateCloud 可以在两种形态下运行：`mate.rpc.mode = local` 为单体模式，一个 JAR 即可启动，默认端口 `9010`，无需 Nacos / Dubbo / RabbitMQ，前端 `/api` 代理不需要改动；`mate.rpc.mode = dubbo` 为微服务模式，通过 Nacos + Dubbo + 网关运行多进程服务。这一设计对开发和交付很实用，本地开发、PoC、小团队项目可以先用单体模式快速跑通；业务复杂度上来后，再切换到微服务形态接入注册发现、RPC、网关治理和灰度能力。同时，5.0.8 修复了单体模式下的关键问题，包括单体默认端口从 `8080` 调整为 `9010`，与网关端口保持一致；放行 captcha / sso / ldap 等公共路径，修复滑块验证码 401；单体登录改查 `mate_admin`，修复 `admin` 账号登录提示“账号或密码错误”；域事件在单体模式下走进程内分发，避免对 RabbitMQ 的强依赖；Flyway 单表 + 自动领养既有 schema，使单体和微服务可以共用同一库。

AI 原生能力

MateCloud 5.0.8 内置 `mate - ai - starter`，基于 Spring AI 2.0 提供 AI 工程能力：`@Tool` 自动发现，任何 Spring Bean 方法标注 `@Tool` 后即可成为 AI 可调用工具；支持多轮会话记忆；支持流式对话；支持 6 类 LLM 提供商：Anthropic、OpenAI、智谱、Minimax、DeepSeek、Ollama；支持 OpenAI compatible 场景，便于接入 Kimi / Moonshot 等兼容端点。这让业务系统里的领域方法可以直接变成 AI 工具，例如字典查询、服务健康检查、代码生成、配置初始化、RPC 调用等，都可以通过自然语言驱动。

MCP 原生工程闭环

5.0.8 强化了 MateCloud 的 MCP 工程闭环能力。`mate - cli --mcp` 可以作为 MCP stdio server，把 CLI 命令和业务服务里的 `@Tool` 方法暴露给 Claude Code、Claude Desktop 等支持 MCP 的 Agent。这条链路的价值在于，AI Agent 不只是“回答问题”，而是可以进入真实工程闭环：观察，查询服务列表、健康状态、Nacos 配置、数据库状态；推理，判断下一步要生成代码、调用 RPC，还是迁移数据库；执行，通过 CLI 或业务 `@Tool` 触发实际操作；反馈，把执行结果返回给 Agent，继续下一轮处理。这也是 5.0.8 的一个核心定位：MateCloud 不只是微服务脚手架，也是 AI Agent 时代的工程操作底座。

开源版核心服务

开源版包含四个核心服务：`mate - gateway` 为 API 网关，端口 `9010`；`mate - auth` 为认证服务，端口 `9020`；`mate - system` 为系统管理，端口 `9030`；`mate - notice` 为通知服务，端口 `9050`。项目完整展示 DDD 四层结构：trigger、application、domain、infrastructure。同时采用 CQRS 读写分离，CommandService 负责写侧，QueryService 负责读侧，让业务边界更清晰，也方便扩展复杂业务模块。

27 个 Starter

MateCloud 将常见横切能力封装为 Starter，业务模块通过 Maven 依赖引入即可自动生效。开源版包含 27 个即插即用 Starter（18 核心 + 9 高级），覆盖数据源、MyBatis Plus、Druid、Flyway；Web、全局异常、Jackson；Caffeine + Redis 二级缓存；Redisson 分布式锁；Nacos 注册发现与配置中心；Dubbo RPC；Sa - Token 认证鉴权；RabbitMQ、延迟队列、领域事件；XXL - Job；MinIO 文件存储；EasyExcel；多租户；Seata 分布式事务；ShardingSphere 分库分表；Sentinel 限流降级；灰度发布；轻量工作流；Aviator 规则引擎；Spring AI + MCP；Testcontainers 测试支持。项目理念是“最小公共、各司其职、Starter = 即插即用能力”。业务服务不需要重复搭建基础设施能力，直接聚焦领域建模。

治理能力

MateCloud 5.0.8 面向 SaaS 与企业后台场景内置了多项治理能力：多租户支持行级隔离、Schema 隔离、独立数据源三种模式；数据权限通过 `@DataPermission` 注解式行级数据过滤；接口签名通过 `@ApiSign` + HMAC - SHA256 防篡改；限流降级通过 `@RateLimit` + Sentinel 动态规则；幂等控制通过 `@Idempotent` 防重复提交；审计日志通过 `@AuditLog` 自动记录操作；灰度发布采用 Dubbo + Gateway 双链路灰度路由；可观测性通过 Actuator、Prometheus、Tracing。安全方面，5.0.8 对租户上下文、数据权限、Dubbo 透传等边界做了 fail - closed 处理：缺失或非法租户上下文时拒绝请求，Scope ID 做校验与转义，避免 SQL 注入和租户绕过。

管理后台与文档完善

本次版本同步更新了中文 README、架构全景图和后台真实运行截图，覆盖工作台 / 服务健康、菜单管理、角色管理、管理员分配角色、数据字典、参数配置、身份接入、灰度发布 / 路由测试、登录审计。同时提供 VitePress 文档站，覆盖架构设计、Starter 使用、CLI 命令、前端开发、数据库迁移、Docker 部署和生产部署。

快速开始

基础环境要求 JDK 21+、Maven 3.9+、Docker & Docker Compose、Node.js 20+。启动后端服务：先编译，`mvn clean install -DskipTests`；再启动基础设施（MySQL + Redis + RabbitMQ + Nacos + MinIO），`make infra - up`；接着初始化 Nacos 配置，`java -jar mate - cli/target/mate - cli.jar config init`；最后启动所有服务，`make up`。启动前端：`cd mate - ui`，`pnpm install`，`pnpm dev`。默认访问：后端网关 `http://localhost:9010`，前端后台 `http://localhost:3000`，Nacos 控制台 `http://localhost:8848`，默认账号 `admin / admin123`。

CLI 示例

CLI 示例包括 `mate new module mate - order`、`mate new aggregate Order --module mate - order`、`mate service list`、`mate service health`、`mate config init`、`mate gen code --table mate_order`、`mate ai chat "列出所有用户状态字典"`、`mate --mcp`。

项目地址

项目地址：GitHub [https://github.com/matevip/matecloud](https://github.com/matevip/matecloud)，许可证为 Apache License 2.0。

小结

MateCloud 5.0.8 的发布，标志着项目从传统 Java 微服务脚手架升级为“AI 原生 + 云原生 + DDD + MCP 工程闭环”的新一代开发底座。对于希望采用 Spring Boot 4、Spring Cloud 2025、Dubbo 3、Spring AI 2.0 构建企业后台、SaaS 平台或 AI 原生业务系统的开发者来说，MateCloud 5.0.8 提供了一套可运行、可扩展、可治理的开源参考实现。