41a0d88c9fa6f606d00ca49779797c09b7394217
简介
youlai-boot-multi 是 youlai-boot 的多模块版本,基于 Spring Boot 4,将原单体项目拆分为独立模块,实现业务解耦与按需引用。配套前端 vue3-element-admin,共享同一套 API 规范与数据库结构。
📌 本项目为 youlai-boot 的
multi-module分支,克隆时请切换分支。
核心特性
- 🔐 安全体系 — Spring Security + JWT/Redis Token 双会话模式、令牌续期、多端互斥
- 🛡️ 细粒度权限 — RBAC 五级:数据 → 菜单 → 按钮 → 接口 → 字段
- ⚡ 代码生成器 — 一键生成前后端 CRUD 代码
- 📦 模块齐全 — 用户、角色、菜单、部门、字典、文件、定时任务、消息中心、操作日志
- 🔌 实时通信 — SSE 推送:在线用户数、字典同步、通知广播
- 🧩 模块解耦 — 事件驱动通信,模块间零循环依赖
快速开始
环境要求:JDK 17+ · MySQL 8.0+ · Redis 6.0+
- 克隆项目:
git clone -b multi-module https://gitee.com/youlaiorg/youlai-boot.git - 导入数据库:
sql/youlai_admin.sql - 修改配置(可选,默认已配置线上只读数据源):
youlai-application/src/main/resources/application-dev.yml - 启动服务(运行
youlai-application模块的YouLaiBootApplication),访问 http://localhost:8000/doc.html
默认账号:admin / 123456
Docker 部署:cd docker && docker-compose up -d
技术栈
| 技术 | 版本 | 说明 |
|---|---|---|
| Spring Boot | 4.0.5 | 核心框架 |
| Spring Security | 6.x | 认证授权 |
| MyBatis-Plus | 3.5.15 | ORM 框架 |
| Druid | 1.2.24 | 数据库连接池 |
| Redis + Redisson | 6.0+ / 4.1.0 | 缓存 · 会话 · 分布式锁 |
| Caffeine | 2.9.3 | 本地缓存 |
| XXL-Job | 3.2.0 | 分布式定时任务 |
| Knife4j | 4.5.0 | API 文档 |
| MapStruct | 1.6.3 | 对象映射 |
| MinIO | 8.5.10 | 对象存储 |
目录结构
youlai-boot-multi/
├── youlai-application/ # 启动模块(入口)
├── youlai-common/ # 公共模块(常量/枚举/事件/统一响应)
├── youlai-framework/ # 技术框架层
│ ├── apidoc/ # OpenAPI / Knife4j
│ ├── cache/ # Redis / Caffeine 缓存
│ ├── captcha/ # 图形验证码
│ ├── integration/ # 短信 / 邮件 / 微信
│ ├── job/ # XXL-Job 定时任务
│ ├── mybatis/ # MyBatis-Plus 配置
│ ├── security/ # Security / JWT / Token
│ └── web/ # 全局异常 / 跨域 / 限流
├── youlai-system/ # 系统业务(用户/角色/菜单/部门)
├── youlai-auth/ # 认证授权(登录/登出/令牌)
├── youlai-file/ # 文件服务(MinIO/本地/OSS)
├── youlai-message/ # SSE 消息推送
├── youlai-codegen/ # 代码生成器
├── docker/ # Docker 部署编排
├── sql/ # 数据库初始化脚本
└── pom.xml # Maven 依赖管理
模块依赖关系
youlai-application ──→ youlai-system ──→ youlai-framework ──→ youlai-common
──→ youlai-auth ──→ youlai-framework
──→ youlai-file ──→ youlai-framework
──→ youlai-message──→ youlai-framework
──→ youlai-codegen──→ youlai-framework
生态矩阵
前端
| 项目 | 技术栈 | 说明 |
|---|---|---|
| vue3-element-admin | Vue 3 + Element Plus | PC 管理前端(主推) |
| youlai-app | Vue 3 + UniApp | 移动端 App |
后端
| 项目 | 技术栈 | 说明 |
|---|---|---|
| youlai-nest | NestJS + TypeORM | Node.js |
| youlai-gin | Go + Gorm | Go |
| youlai-django | Django + DRF | Python |
| youlai-thinkphp | ThinkPHP 8 | PHP |
| youlai-aspnet | ASP.NET Core | C# |
youlai-boot 还提供以下变种和分支版本:多租户(Spring Boot 4)· MyBatis-Flex(Spring Boot 4)· Spring Boot 3 · PostgreSQL · 多模块
六种后端共享同一套 RESTful API 规范 和 数据库结构,前端可无缝切换。
文档资源
| 资源 | 地址 |
|---|---|
| 📖 完整文档站 | www.youlai.tech |
| 🖥️ PC 端在线预览 | vue.youlai.tech |
| 📱 移动端在线预览 | app.youlai.tech |
| 🔗 Apifox 接口文档 | apifox.com |
| 🔗 本地接口文档 | localhost:8000/doc.html |
参与贡献
欢迎提交 Issue 和 Pull Request!详见 贡献指南。
开源协议
本项目基于 Apache License 2.0 开源,可免费用于商业项目。
公众号「有来技术」 添加作者微信
技术交流 · 问题反馈 · 商务合作
Description
Languages
Java
100%


