# 别再学 RuoYi 了，这个 JDK21 微服务框架 5 分钟就能跑起来

📑 文章目录

  • 一、你是否还在学 RuoYi？
  • 二、传统框架的通病
    • 2.1 业务耦合太重
    • 2.2 代码量臃肿
    • 2.3 多模块架构的痛点
  • 三、MetaLite：业务无关的技术底座
    • 3.1 核心理念
    • 3.2 单 Maven 工程架构
    • 3.3 为什么能做到轻量？
  • 四、5 分钟上手演示
    • 4.1 环境准备
    • 4.2 克隆工程
    • 4.3 修改包名
    • 4.4 配置 MySQL 和 Redis 密码
    • 4.5 启动 Nacos
    • 4.6 IDEA 配置启动
    • 4.7 验证
  • 五、接下来做什么？
  • 六、总结

10 万行代码、6 个模块、JDK 8 —— 2026 年了，微服务框架该换代了。

一、你是否还在学 RuoYi？

前段时间，一个朋友问我："现在学微服务，是不是得先把 RuoYi 跑起来？"

我翻开他的电脑一看：RuoYi-Cloud，6 个子模块、10 万+行代码、50 多个三方依赖、技术栈停留在 JDK 8 + Spring Boot 2.x。光是把项目导入 IDEA 就花了 3 分钟，启动一次要等 2 分钟，改个包名要重构半天。

我问他："你学这个，是为了做电商？做 IoT？做政务？"

他说："都不是，就是想搭个技术底座，快速开发自己的业务。"

我说："那你真的不需要学 RuoYi。"

二、传统框架的通病

RuoYi 和芋道源码是国内最火的两个微服务框架，Gitee Star 都破 3 万。但用过的人都会遇到同样的问题：

2.1 业务耦合太重

RuoYi = 技术底座 + 商品管理 + 会员中心 + 营销系统 + 工作流 + ...

看似功能丰富，但实际企业的业务需求千差万别：

  • 内置的商品管理，做 IoT 的用不上
  • 内置的营销系统，做政务的不能要
  • 内置的工作流，做电商的觉得多余

结果就是：二次开发需要深入理解框架内置的业务逻辑，学习成本极高。而且企业业务变化快，内置功能很快过时。

2.2 代码量臃肿

维度RuoYi/芋道MetaLite
代码行数10~15 万行~2.5 万行
三方依赖50~60 个~20 个
模块数量6~10 个单 Maven 工程
技术栈JDK 8/11JDK 21
启动时间1~2 分钟10 秒

10 万行代码是什么概念？意味着你光是理解框架结构，就要花掉一两周。

2.3 多模块架构的痛点

RuoYi 采用多 Maven 模块架构：

ruoyi-cloud/
├── ruoyi-gateway # 网关
├── ruoyi-auth # 认证
├── ruoyi-modules/ # 业务模块
│   ├── ruoyi-system
│   ├── ruoyi-gen
│   └── ruoyi-job
├── ruoyi-api/ # API 接口
└── ruoyi-common/ # 公共组件

看似清晰，但实际开发中：

  • 跨模块调用需要引依赖，IDE 重构慢
  • 跨模块断点跳转复杂，调试体验差
  • 重构牵一发而动全身，改个接口要改多个模块
  • 多模块打包，版本容易冲突

三、MetaLite：业务无关的技术底座

MetaLite（元界）是一款基于 JDK 21 + Spring Cloud Alibaba 构建的轻量级微服务技术底座。

它与传统框架最大的不同：完全业务无关。

3.1 核心理念

MetaLite = 纯粹的技术底座（21 项企业级能力） + 快速开发骨架

不内置任何业务功能：

  • ❌ 没有商品管理
  • ❌ 没有会员中心
  • ❌ 没有营销系统

只提供技术能力：

  • ✅ JDK 21 虚拟线程（IO 密集型场景性能提升 10 倍）
  • ✅ 二级缓存分布式同步（@CacheEvict 自动通知其他实例）
  • ✅ ORM 零 XML 配置（Criteria 方法引用，编译期类型安全）
  • ✅ 全链路 TraceId 自动传播
  • ✅ 分布式事务 Seata 2.1（零配置启动）
  • ✅ 三层维度限流（无需 Sentinel）
  • ✅ 国密算法 SM2/SM3/SM4（等保合规）

3.2 单 Maven 工程架构

这是与同类框架最大的不同：

backend-demo/
├── pom.xml # 一个 POM 文件
├── src/main/java/
│   └── com.yourcompany.demo/
│       ├── controller/ # 控制层
│       ├── service/ # 业务层
│       ├── dao/ # 数据访问层
│       └── domain/ # 领域模型
└── src/main/resources/
    └── application.yml # 配置文件

优势很明显：

对比项多 Maven 模块单 Maven 工程
跨模块调用需引依赖，IDE 重构慢包内调用，IDE 飞起
调试效率跨模块断点跳转复杂单进程断点连续跳转
打包部署多模块打包，版本易冲突一个 jar 包，依赖清晰
重构成本跨模块重构需改多个 POM包结构调整，IDE 自动重构

3.3 为什么能做到轻量？

浅层封装原则：MetaLite 不重新发明轮子，而是对成熟的三方组件做薄封装。

比如 ORM 层，不自己写数据库连接池，而是封装 Druid + 自研轻量级 ORM；比如分布式事务，不自己实现，而是封装 Seata 2.1。

这样做的结果是：

  • 代码量只有传统框架的 1/3
  • 依赖只有传统框架的 1/2
  • 学习成本极低

四、5 分钟上手演示

理论说再多，不如跑起来。我们看看 MetaLite 上手有多快。

4.1 环境准备

你需要准备以下环境：

环境版本说明
JDK21+必须 JDK 21，虚拟线程是核心特性
Maven3.8+构建工具
MySQL8.0+数据库
Redis7.0+缓存和分布式锁
Nacos2.3+注册中心和配置中心

4.2 克隆工程

git clone https://gitee.com/MetaLite/backend-demo.git
cd backend-demo

4.3 修改包名

将 com.metalite.demo 改为你自己的包名，比如 com.yourcompany.yourproject。

IDEA 中直接右键包名 → Refactor → Rename，10 秒完成。

4.4 配置 MySQL 和 Redis 密码

打开 application.yml，修改 MySQL 和 Redis 连接信息：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/your_db?useUnicode=true&characterEncoding=utf8
    username: root
    password: your_mysql_password
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: your_redis_password

4.5 启动 Nacos

# Linux/Mac
sh nacos/bin/startup.sh -m standalone
Windows
cmd nacos/bin/startup.cmd -m standalone

访问 http://127.0.0.1:8848/nacos，默认账号密码 nacos/nacos。

4.6 IDEA 配置启动

  • Main class：com.metalite.demo.DemoApplication
  • VM Options：-Dspring.profiles.active=dev

点击运行，10 秒后启动成功。

4.7 验证

访问健康检查接口：

http://127.0.0.1:8080/health

返回：

{
  "status": "UP"
}

至此，5 分钟到了。你的第一个微服务已经跑起来了。

五、接下来做什么？

跑起来只是第一步，接下来你可以：

  1. 阅读架构文档：理解 MetaLite 的设计理念和核心组件
  2. 查看示例代码：backend-demo 中包含了完整的 CRUD、缓存、MQ 示例
  3. 开始开发业务：按照 controller → service → dao → domain 四层架构开发
  4. 部署上线：参考 docs/deployment/ 中的 Docker/K8s/Bin 脚本

六、总结

MetaLite 不是另一个 RuoYi，而是 RuoYi 该成为的样子：

维度RuoYiMetaLite
定位业务框架技术底座
代码量10~15 万行~2.5 万行
技术栈JDK 8/11JDK 21
工程结构6~10 个模块单 Maven 工程
上手时间半天5 分钟
持续演进内置业务很快过时技术底座持续迭代

MetaLite 是基于 JDK21 + Spring Cloud Alibaba 的轻量级微服务技术底座，致力于为企业提供纯粹的技术底座解决方案。

如果你对轻量级微服务框架感兴趣，可以在 Gitee 开源平台搜索 "MetaLite" 找到示例工程地址，了解更多技术细节和设计理念。

框架简介：元界 MetaLite — 下一代企业级 Java 微服务技术底座

作者简介：基于 Spring 体系 15 年企业级开发经验，专注于通过企业级生产环境落地的工程思维和架构思想打造下一代Java 微服务技术底座

完整文档与源码：gitee.com/MetaLite

# java # spring cloud # spring
Logo
亚马逊云科技技术品牌专区

更多推荐

open-code-review Codex 插件教程：对话式调用评审技能指南

本文是一份面向新手的 **open-code-review Codex 插件教程**，教你在 Codex 中通过对话式方式调用 open-code-review 的 AI 代码评审技能。open-code-review 是阿里巴巴开源的 AI 代码评审工具，采用"确定性流水线 + LLM Agent"混合架构，内置多语言评审规则（NPE、线程安全、XSS、SQL 注入等），可在 Codex 里用一

avatar 亚马逊云科技技术品牌专区

OBS Studio 完整指南：免费开源录屏与直播软件从零上手

想做一场像模像样的直播，或者把屏幕内容录成教程视频，但一想到商用软件的订阅费就有些犹豫？其实你不需要花一分钱。OBS Studio 是一款免费开源的直播与录屏软件，支持 Windows、macOS 和 Linux，采集、混音、编码、推流、录制，一条流水线全包了。## 先搞清楚 OBS Studio 是什么OBS Studio 是一个"场景化"的采集合成工具：你把摄像头、窗口、浏览器、图片、

avatar 亚马逊云科技技术品牌专区

如何用MediaCrawler爬取小红书抖音数据？7大平台爬虫从安装到实战完整指南

MediaCrawler 是一个支持小红书、抖音、快手、B站、微博、百度贴吧、知乎的开源自媒体数据采集工具。它能按关键词、按帖子、按创作者主页三种方式抓取笔记/视频内容、评论甚至二级评论，并把结果存成 JSON、CSV、Excel 或数据库。适合做市场调研、竞品监控、内容选题的运营人员，以及想要现成爬虫框架而不想从零写 JS 逆向的开发者。## 从一次"手动抄数据"说起想象这个场景：你负责

avatar 亚马逊云科技技术品牌专区