MateCloud 5.0.8 正式版发布。这一版不是普通的依赖升级而是一次面向 2026 年 Java 工程体系的重新整理Spring Boot 4、Spring Cloud 2025、Dubbo 3、Spring AI 2.0、Java 21、MCP、DDD、单体/微服务双形态被放进了同一套开源脚手架里。如果你正在做企业后台、SaaS、多租户平台、微服务治理或者想把 AI Agent 接入自己的 Java 业务系统MateCloud 5.0.8 值得看一下。一、这次发布解决的核心问题很多 Java 后台脚手架能生成 CRUD也能跑通 Spring Cloud但一到真实项目里就会遇到几个问题第一微服务太重。刚开始做业务时上来就 Nacos、Dubbo、RabbitMQ、网关、多个服务进程开发和调试成本很高。第二单体又难演进。很多项目先用单体跑起来但后续拆服务时配置、RPC、事件、数据库迁移、前端代理都要重做。第三AI 能力还停留在“聊天接口”。业务系统里的领域方法、服务治理、代码生成、配置管理、数据库迁移并没有自然暴露给 AI Agent。MateCloud 5.0.8 的方向很明确一套业务代码既能单体交付也能微服务部署同时把 AI Agent 需要的工具调用和 MCP 闭环变成工程能力。二、技术栈直接对齐新一代 Java 云原生体系MateCloud 5.0.8 的核心依赖技术版本Java21Spring Boot4.0.7Spring Cloud2025.1.2Spring Cloud Alibaba2025.1.0.0Dubbo3.3.6Spring AI2.0.0MyBatis Plus3.5.16Sa-Token1.45.0Redisson4.5.0前端Vue 3.5 Element Plus Vite这套组合的意义是它不是维护一个旧版后台模板而是把 Spring 生态的新版本、AI 工程能力和微服务治理能力一起收敛到项目骨架中。三、最重要的新变化单体 / 微服务双形态5.0.8 新增mate-monolith单体组合根让 MateCloud 支持两种运行模式。单体模式mate.rpc.modelocal单体模式下一个 JAR 即可启动默认端口是9010和网关端口保持一致。这样前端/api - 127.0.0.1:9010的代理配置不需要改。单体模式不需要 Nacos、Dubbo、RabbitMQ。域事件走进程内分发RPC 走本地适配适合本地开发、PoC、小团队项目和早期交付。微服务模式mate.rpc.modedubbo微服务模式下系统通过 Nacos Dubbo Gateway 运行多进程服务mate-gatewayAPI 网关端口9010mate-auth认证服务端口9020mate-system系统管理端口9030mate-notice通知服务端口9050这条路径适合业务规模扩大后的服务拆分、灰度发布、限流熔断、链路追踪和分布式事务。5.0.8 针对单体模式做了多项修复默认端口从8080调整到9010放行 captcha / sso / ldap 公共路径修复滑块验证码 401登录改查mate_admin修复admin登录错误关闭单体模式下不必要的 Dubbo / Nacos 依赖Flyway 单表 自动领养既有 schema单体和微服务可以共用同一数据库。四、AI 原生Spring AI 2.0 Tool MCPMateCloud 5.0.8 内置mate-ai-starter基于 Spring AI 2.0 提供 AI 工程能力。它支持Tool自动发现多轮会话记忆流式对话Anthropic / OpenAI / 智谱 / Minimax / DeepSeek / Ollama 等 6 类模型提供商OpenAI compatible 接入MCP Server 桥接。一个业务方法只要标注Tool就可以被 LLM 调用ComponentRequiredArgsConstructorpublicclassDictAiTools{privatefinalIDictQueryServicedictQueryService;Tool(descriptionList all dict entries for a given dictType.)publicListDictDatalistDictByType(ToolParam(descriptionDict type code, e.g. user_status)StringdictType){returndictQueryService.findByType(dictType);}}这意味着后台系统里的字典查询、服务健康检查、配置初始化、代码生成、RPC 调用都可以变成 AI Agent 的工具。五、MCP 工程闭环让 Agent 真正操作系统MateCloud 的mate-cli不只是普通命令行工具它可以启动 MCP Servermate--mcp或者java-jarmate-cli/target/mate-cli.jar--mcp这样 Claude Code、Claude Desktop 等支持 MCP 的 Agent 就可以调用 MateCloud 暴露出来的工具。这条链路可以形成一个工程闭环Agent 查询服务列表和健康状态判断某个服务是否异常调用 CLI 或业务Tool执行检查生成代码、初始化配置或迁移数据库根据执行结果继续下一轮操作。这就是 MateCloud 5.0.8 里“AI 原生”的含义不是加一个聊天框而是让 AI 能进入工程系统的观察、推理、执行、反馈循环。六、DDD 四层 CQRS不只是代码生成器MateCloud 采用 DDD 四层结构triggerapplicationdomaininfrastructure同时使用 CQRS 读写分离CommandService 负责写操作QueryService 负责读操作。这种结构比普通三层 CRUD 模板更适合复杂业务领域层可以保持更干净基础设施适配可以替换读写职责也更明确。对学习 DDD、微服务和 Spring AI 的开发者来说MateCloud 不是一堆片段代码而是一套可以运行的参考工程。七、27 个 Starter把横切能力下沉成依赖MateCloud 把常见能力封装成 Starter。业务模块只需要引入 Maven 依赖就能获得对应能力。覆盖范围包括数据源、MyBatis Plus、Druid、FlywayWeb、全局异常、JacksonCaffeine Redis 二级缓存Redisson 分布式锁Nacos 注册发现与配置中心Dubbo RPCSa-Token 认证鉴权RabbitMQ、延迟队列、领域事件XXL-JobMinIO 文件存储EasyExcel多租户Seata 分布式事务ShardingSphere 分库分表Sentinel 限流降级灰度发布轻量工作流Aviator 规则引擎Spring AI MCPTestcontainers 测试支持。这个设计的好处是业务模块不用重复写基础设施代码。Starter 负责能力沉淀业务服务只聚焦领域建模。八、多租户、安全和治理能力MateCloud 5.0.8 面向 SaaS 和企业后台场景内置了多项治理能力多租户行级隔离、Schema 隔离、独立数据源数据权限DataPermission接口签名ApiSign HMAC-SHA256限流RateLimit Sentinel审计AuditLog幂等Idempotent灰度发布Dubbo Gateway 双链路路由可观测Actuator、Prometheus、Tracing。安全边界上5.0.8 对租户上下文、数据权限、Dubbo 透传做了 fail-closed 处理。缺失或非法租户上下文时拒绝请求Scope ID 做校验和转义避免租户绕过和 SQL 注入。九、界面预览MateCloud 5.0.8 同步更新了后台真实运行截图。下面几张图来自项目仓库中的运行截图。后台覆盖工作台、菜单管理、角色管理、管理员、数据字典、参数配置、身份接入、灰度发布、登录审计等常见企业后台能力。十、快速开始基础环境JDK 21Maven 3.9Docker Docker ComposeNode.js 20后端启动# 1. 编译mvn cleaninstall-DskipTests# 2. 启动基础设施makeinfra-up# 3. 初始化 Nacos 配置java-jarmate-cli/target/mate-cli.jar config init# 4. 启动所有服务makeup前端启动cdmate-uipnpminstallpnpmdev默认地址后端网关http://localhost:9010 前端后台http://localhost:3000 Nacos 控制台http://localhost:8848默认账号admin / admin123十一、CLI 常用命令mate new module mate-order mate new aggregate Order--modulemate-order mateservicelist mateservicehealth mate config init mate gen code--tablemate_order mate ai chat列出所有用户状态字典mate--mcp这些命令覆盖模块脚手架、聚合生成、服务发现、健康检查、Nacos 配置、代码生成、AI 对话和 MCP Server。结语MateCloud 5.0.8 的重点不是“又一个后台管理系统模板”而是把 Java 企业应用开发中几条正在合流的趋势放到了一起Spring Boot 4 / Spring Cloud 2025 的新技术栈DDD CQRS 的工程结构单体到微服务的演进路径Starter 化的横切能力沉淀Spring AI 2.0 与 MCP 带来的 AI 工程闭环。对于想用 Java 构建企业后台、SaaS 平台、微服务系统或者希望把 AI Agent 接入业务系统的团队来说MateCloud 5.0.8 提供了一套值得参考的开源底座。项目地址GitHubhttps://github.com/mateaix/matecloudGiteehttps://gitee.com/matevip/matecloud官网https://mate.vip