youlai-boot/README.md

youlai-boot

Spring Boot 企业级权限管理系统后端

项目简介

youlai-boot 是一套基于 Spring Boot 的企业级权限管理系统后端，配套前端 vue3-element-admin 和移动端 youlai-app，并提供 7 种语言实现（Java / Node.js / Go / Python / PHP / C# / Rust），共享同一套 API 规范与数据库结构。适用于企业中后台管理系统的学习参考与二次开发。

核心特性

• 🔐 安全体系 — Spring Security + JWT/Redis Token 两种令牌格式、统一会话管理、令牌续期、多端互斥

• 🔑 统一认证（可选，默认关闭） — OIDC 登录，把登录交给外部认证中心，认证成功后关联本地用户并复用角色权限；不启用就不会加载相关组件

• 🛡️ 细粒度权限 — RBAC 五级：数据 → 菜单 → 按钮 → 接口 → 字段

• ⚡ 代码生成器 — 一键生成前后端 CRUD 代码

• 📦 模块齐全 — 用户、角色、菜单、部门、字典、文件(OSS/RustFS/本地)、定时任务、消息中心、操作日志

• 🔀 工作流 — Flowable 审批流：BPMN 在线设计、条件网关、角色审批、驳回回退

• 🌐 多租户 SaaS — 数据隔离 + 租户配置，独立 youlai-boot-tenant 版本

• 🔌 实时通信 — WebSocket 接入：一次性票据鉴权、节点在线人数、字典同步、通知提示

系统预览

PC 端

移动端

快速开始

环境要求：JDK 17+ · MySQL 8.0+ · Redis 6.0+

1. 克隆项目：

   git clone https://gitee.com/youlaiorg/youlai-boot.git
   

2. 导入数据库：

   # 基础库（必装）
   sql/youlai-admin.sql
   
   # 可选扩展：不装不影响基础功能，需在基础库之后执行
   sql/extensions/dynamic-form.sql # 动态表单
   sql/extensions/workflow.sql   # 工作流（Flowable 演示流程与演示账号，非引擎表）
   sql/extensions/oidc.sql        # 统一认证：应用中心菜单与演示身份关联
   

   扩展脚本全部可选。用户、角色、菜单、字典、日志、代码生成等基础能力都在 sql/youlai-admin.sql 里，只导入基础库就能把系统跑起来。

   oidc.sql 面向已有认证中心的场景，只写入「应用中心」菜单和一条演示身份关联。后端通过 security.oidc.enabled 控制 OIDC，默认关闭；开启时必须填写认证中心、客户端 ID、客户端密钥和前端回跳地址。前端登录入口通过 VITE_OIDC_ENABLED 单独控制。暂时没有单点登录需求，跳过即可。

3. 检查开发配置，按实际环境填写 MySQL、Redis 连接信息：

   src/main/resources/application-dev.yml
   

   配置按「基础服务 → 安全与访问 → 文件与接口 → 可选扩展」排列。首次运行先看前半部分；邮件、短信、小程序、定时任务、OIDC、AI、工作流集中在后半部分，按需接入。--- 分隔的各组都属于同一个环境，会一起加载。

   application.yml 维护公共规则，application-dev.yml 和 application-prod.yml 只展开常用参数与接入信息。验证码外观、登录期限、连接池等沿用默认值，需要调整时再添加对应属性，IDE 可提示配置说明与默认值。文件上传的存储方式与凭据在 storage 段配置。

   可选服务中的 "" 表示尚未接入，使用时填写自己的凭据；没有相关需求可以跳过。邮件默认使用端口 587、SMTP 认证和 STARTTLS，其他邮件服务按需覆盖。微信认证源默认 wechat-mini-main，首次接入无需填写 provider；更换 AppID 时需改用新的 wx.miniapp.provider，避免复用已有身份关联。

   本地接入可以直接填写 YAML，生产部署也可用外部配置文件或 Spring Boot 原生环境变量覆盖，例如 WX_MINIAPP_APPID、SECURITY_OIDC_ENABLED。无需在 YAML 中重复声明 ${变量名:默认值}；变量名转换规则为点改下划线、去掉连字符、转大写。实际密钥不要提交到版本库。

   上传大小在 spring.servlet.multipart 中配置，单文件和整个请求默认均为 50MB。升级时请把原 storage.upload.max-file-size 的自定义值分别迁移到 max-file-size 和 max-request-size。

   生产环境的 SQL 日志通过 SLF4J 接入 Logback。排查 SQL 时可临时将对应 Mapper 包的日志级别设为 DEBUG，默认 INFO 不输出 SQL 调试日志。

4. 启动服务：

   方式一：IDEA 启动（推荐） 用 IDEA 打开项目，等待 Maven 依赖下载完成，运行启动类 YouLaiBootApplication 即可。

   方式二：命令行启动

   mvn spring-boot:run
   

   启动后访问 http://localhost:8000/swagger-ui.html，能打开接口文档即说明后端已正常运行。

5. 启动前端（可选）： 如需可视化操作界面，启动配套前端 vue3-element-admin，访问 http://localhost:3000，使用 admin / 123456 登录。

更多内容详见官方文档：快速开始 · 部署指南

目录结构

youlai-boot/
├── docs/                      # 项目文档与图片资源
├── sql/                       # 数据库初始化脚本
├── src/                       # 源码目录
│   ├── auth/                  # 认证模块
│   │   ├── password/          # 账号密码登录（含图形验证码）
│   │   ├── sms/               # 短信验证码登录
│   │   ├── qrcode/            # 扫码登录
│   │   ├── wxma/              # 微信小程序登录
│   │   └── session/           # 登录态管理（登出 / 刷新令牌）
│   ├── codegen/               # 代码生成器
│   ├── common/                # 公共模块（常量/枚举/异常/统一响应/工具类）
│   ├── config/                # 配置类（Security/Redis/MyBatis/接口文档/跨域/定时任务等）
│   ├── framework/             # 基础设施层
│   │   ├── mybatis/           # MyBatis-Plus 配置
│   │   ├── security/          # Spring Security
│   │   │   ├── config/        # 安全配置与配置属性
│   │   │   ├── filter/        # Token 认证过滤器
│   │   │   ├── handler/       # 认证 / 授权失败处理器
│   │   │   ├── model/         # 安全模型（SecurityUser / 令牌 / 数据范围）
│   │   │   ├── port/          # 认证与权限端口（由 system 提供实现）
│   │   │   ├── service/       # 用户详情与权限服务
│   │   │   ├── token/         # Token 管理（JWT / Redis 双模式）
│   │   │   └── util/          # 安全工具类
│   │   └── web/               # Web 层（全局异常/跨域/限流）
│   ├── module/                # 业务扩展模块
│   │   ├── form/              # 动态表单
│   │   └── workflow/          # 工作流
│   ├── support/               # 能力服务
│   │   ├── ai/                # AI 对话（代码生成/动态表单/工作流辅助，默认关闭）
│   │   ├── file/              # 文件存储（RustFS/阿里云OSS/本地）
│   │   ├── mail/              # 邮件服务
│   │   ├── sms/               # 短信服务
│   │   └── realtime/          # WebSocket 实时通信
│   └── system/                # 系统业务（用户/角色/菜单/部门/字典等）
├── docker-compose.yml         # 中间件一键编排（MySQL/Redis/RustFS/Xxl-Job）
└── pom.xml                    # Maven 依赖管理

生态矩阵

前端

项目	技术栈	说明	更新状态
vue3-element-admin	Vue 3 + Element Plus	PC 管理前端（主推）	✅️
youlai-app	Vue 3 + UniApp	移动端 App	✅️

后端

项目	技术栈	说明	更新状态
youlai-boot	Spring Boot + MyBatis-Plus	Java（主推）	✅️
youlai-nest	NestJS + TypeORM	Node.js	✅️
youlai-gin	Go + Gorm	Go	✅️
youlai-django	Django + DRF	Python	✅️
youlai-fastapi	FastAPI + SQLAlchemy	Python	✅️
youlai-think	ThinkPHP + ThinkORM	PHP	✅️
youlai-aspnet	ASP.NET Core + EF Core	C#	✅️
youlai-axum	Axum + SeaORM	Rust	✅️
youlai-laravel	Laravel + Eloquent	PHP	❌️

九种后端共享同一套 RESTful API 规范 和 数据库结构，前端可无缝切换。

衍生版本

项目	基于	类型	说明	更新状态
youlai-boot-tenant	youlai-boot	独立仓库	多租户 SaaS，租户隔离与租户配置	✅️
youlai-boot-flex	youlai-boot	独立仓库	改用 MyBatis-Flex	✅️
youlai-boot (db-pg)	youlai-boot	分支	PostgreSQL 数据库分支	✅️
youlai-boot (multi-module)	youlai-boot	分支	多模块工程拆分	✅️
youlai-nest (multi-tenant)	youlai-nest	分支	多租户 SaaS，租户隔离与租户配置	✅️
youlai-boot (spring-boot-3)	youlai-boot	分支	Spring Boot 3 兼容分支	❌️

可选扩展

以下功能默认关闭，需要时再开启。

AI 辅助：在当前环境配置中填写密钥，并加上 spring.ai.model.chat: openai。

spring:
  ai:
    model:
      chat: openai
    openai:
      base-url: https://dashscope.aliyuncs.com/compatible-mode/v1
      api-key: ""
      chat:
        model: qwen3.7-flash
        temperature: 0.3
        extra-body:
          "[enable_thinking]": false

工作流：先执行扩展脚本导入菜单、演示角色与发起表单（不含 ACT_* 引擎表），再在环境配置中打开开关。

sql/extensions/workflow.sql

flowable:
  process:
    enabled: true   # 唯一开关，同时控制业务模块和引擎
  idm:
    enabled: false
  eventregistry:
    enabled: false

开发环境启动时自动建表，生产需先建表；演示流程在「流程模型」页点「重置工作流数据」后生成。

统一认证：经 Nginx 接入时，取消环境配置 server 块中 forward-headers-strategy: framework 的注释，并让代理覆盖客户端的 Forwarded / X-Forwarded-*。

多租户：见 youlai-boot-tenant。

技术合作

本项目采用 Apache License 2.0 开源，可免费商用。欢迎在 Issue 提交问题或反馈，也欢迎提交 Pull Request 共建。

如需技术支持、商务合作、二次开发、项目定制或私有化部署，可联系作者微信（见下方二维码）。

公众号「有来技术」

小程序「有来技术」

添加作者微信

技术交流 · 问题反馈 · 商务合作