MateCloud 5.0.8 正式版发布。

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 工程集成场景。

5.0.8 版本的重点是把 MateCloud 从传统微服务脚手架推进到“AI 原生工程底座”：既保留 Spring Cloud + Dubbo + Nacos 的微服务形态，也新增 mate-monolith 单体组合根，让同一套业务代码可以在单体和微服务之间切换；同时引入 Spring AI 2.0、@Tool 自动发现、MCP Server、CLI 工程工具和完整 Starter 体系，为 AI Agent 操作业务系统提供工程闭环。

版本亮点

1. Spring Boot 4 + Spring Cloud 2025 技术栈升级

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 云原生技术栈重新整理的一套工程基座。

2. 单体 / 微服务双形态，一套代码两种部署

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，使单体和微服务可以共用同一库。

3. AI 原生：Spring AI 2.0 + @Tool + 会话记忆 + 流式对话

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 调用等，都可以通过自然语言驱动。

4. MCP 原生工程闭环：让 AI Agent 操作集群

5.0.8 强化了 MateCloud 的 MCP 工程闭环能力。mate-cli --mcp 可以作为 MCP stdio server，把 CLI 命令和业务服务里的 @Tool 方法暴露给 Claude Code、Claude Desktop 等支持 MCP 的 Agent。

这条链路的价值在于，AI Agent 不只是“回答问题”，而是可以进入真实工程闭环：

1. 观察：查询服务列表、健康状态、Nacos 配置、数据库状态；

2. 推理：判断下一步要生成代码、调用 RPC，还是迁移数据库；

3. 执行：通过 CLI 或业务 @Tool 触发实际操作；

4. 反馈：把执行结果返回给 Agent，继续下一轮处理。

这也是 5.0.8 的一个核心定位：MateCloud 不只是微服务脚手架，也是 AI Agent 时代的工程操作底座。

5. DDD 四层 + CQRS，开源版包含核心服务

开源版包含四个核心服务：

• mate-gateway：API 网关，端口 9010；

• mate-auth：认证服务，端口 9020；

• mate-system：系统管理，端口 9030；

• mate-notice：通知服务，端口 9050。

项目完整展示 DDD 四层结构：

• trigger

• application

• domain

• infrastructure

同时采用 CQRS 读写分离，CommandService 负责写侧，QueryService 负责读侧，让业务边界更清晰，也方便扩展复杂业务模块。

6. 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 = 即插即用能力”。业务服务不需要重复搭建基础设施能力，直接聚焦领域建模。

7. 多租户、安全、审计与微服务治理

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 注入和租户绕过。

8. 管理后台与文档同步完善

本次版本同步更新了中文 README、架构全景图和后台真实运行截图，覆盖：

• 工作台 / 服务健康；

• 菜单管理；

• 角色管理；

• 管理员分配角色；

• 数据字典；

• 参数配置；

• 身份接入；

• 灰度发布 / 路由测试；

• 登录审计。

同时提供 VitePress 文档站，覆盖架构设计、Starter 使用、CLI 命令、前端开发、数据库迁移、Docker 部署和生产部署。

快速开始

基础环境：

• JDK 21+

• Maven 3.9+

• Docker & Docker Compose

• Node.js 20+

启动后端服务：

# 1. 编译
mvn clean install -DskipTests
​
# 2. 启动基础设施（MySQL + Redis + RabbitMQ + Nacos + MinIO）
make infra-up
​
# 3. 初始化 Nacos 配置
java -jar mate-cli/target/mate-cli.jar config init
​
# 4. 启动所有服务
make up

启动前端：

cd mate-ui
pnpm install
pnpm dev

默认访问：

• 后端网关：http://localhost:9010

• 前端后台：http://localhost:3000

• Nacos 控制台：http://localhost:8848

• 默认账号：admin / admin123

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

• 许可证：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 提供了一套可运行、可扩展、可治理的开源参考实现。