JeecgBoot 从入门到精通学习笔记

一、顶层认知：平台核心定位与核心理念（入门第一步）

1.1 平台核心定义

JeecgBoot 是一款企业级AI低代码开发平台，采用前后端分离架构，融合AI大模型能力与低代码开发模式，通过「AI生成->OnlineCoding->代码生成->手工MERGE」的全流程开发模式，解决Java项目80%的重复开发工作，兼顾开发效率与业务灵活性。

1.2 核心宗旨与设计理念

• 简单功能：通过OnlineCoding在线配置实现零代码开发，人人皆可快速搭建业务功能
• 复杂功能：通过代码生成器一键生成前后端代码，再通过手工Merge实现低代码开发
• 核心优势：解决传统低代码产品普遍存在的「灵活性不足」痛点，既保证智能化，又支持深度定制编码

1.3 核心适用场景

可应用于所有J2EE项目开发，全面支持信创国产化环境，尤其适配以下场景：

• 企业级管理系统：MIS、OA、ERP、CRM
• 互联网SAAS项目，支持多租户架构
• 企业AI应用快速构建与部署
• 国产化信创环境下的业务系统开发

1.4 开源协议与版权说明

• 开源版采用 Apache-2.0 开源协议，允许商业使用，可基于平台开展业务系统开发
• 禁止使用本软件开发与JeecgBoot形成竞争关系的产品
• 企业版提供额外技术支持与企业级高级功能，与开源版形成能力互补

二、入门准备：环境搭建与快速上手

2.1 环境要求

前端环境

依赖	版本要求	说明
Node.js	20.19+ / 22.12+	Vite不再支持Node.js 18及以下EOL版本
pnpm	9.0+	包管理工具
推荐IDE	IDEA、WebStorm、VSCode	前端开发工具

后端环境

依赖	版本要求	说明
JDK	默认17，支持JDK8、JDK21	开发语言核心环境
Maven	标准版本	依赖管理工具
推荐IDE	IDEA	必须安装Lombok插件
数据库	默认MySQL5.7+	平台默认提供MySQL脚本
缓存	Redis	系统缓存必备组件

2.2 项目获取与资源地址

• 官方网站：http://www.jeecg.com
• 在线演示：平台演示、APP演示、零代码演示
• 源码地址：
  • Github：https://github.com/jeecgboot/JeecgBoot
  • Gitee：https://gitee.com/jeecg/JeecgBoot
• 技术支持：官方文档、视频教程、QQ交流群（964611995）

2.3 快速启动与体验

1. 环境校验：确认Node、JDK、MySQL、Redis环境符合版本要求
2. 项目初始化：拉取源码，后端导入IDEA，前端导入对应IDE
3. 数据库初始化：执行官方提供的MySQL脚本，完成库表初始化
4. 配置修改：修改后端数据库、Redis连接配置，前端接口地址配置
5. 项目启动：先启动后端服务，再启动前端项目
6. 系统访问：通过浏览器访问前端地址，使用默认账号密码登录系统，体验核心功能

三、核心架构体系：底层技术与架构设计

3.1 整体技术架构

前端技术栈

核心技术栈：Vue3.0 + TypeScript + Vite6 + Ant-Design-Vue4
配套生态：pinia + echarts + unocss + vxe-table + qiankun + es6
核心能力：二次封装组件、utils、hooks、动态菜单、权限校验、按钮级别权限控制

后端技术栈

技术模块	核心组件与版本
基础框架	Spring Boot 2.7.18
微服务框架	Spring Cloud Alibaba 2021.0.6.2
持久层框架	MybatisPlus 3.5.3.2
安全框架	Apache Shiro 1.13.0、Jwt 4.5.0
报表工具	JimuReport 1.9.5（积木报表）
工作流引擎	Flowable
数据库连接池	Druid 1.1.24
日志框架	logback
其他核心组件	autopoi、fastjson、poi、Swagger-ui、quartz、lombok

3.2 系统分层架构

自顶向下分为6层，架构解耦，支持灵活扩展：

1. 展示层：PC端、WEB端、APP端、PAD端，全端适配
2. API接口层：API GateWay（防刷、鉴权），统一RESTful接口规范，集成Swagger在线接口文档
3. 业务应用层：基础模块（用户、部门、权限、字典等）、高级模块（OA、流程、大屏、在线开发等）
4. 服务治理层：消息队列、分布式任务、分库分表、分布式事务、监控预警、分布式锁等
5. 基础中间件层：Spring Boot、Spring Cloud、工作流引擎、报表引擎、WebSocket、MQTT等
6. 数据层：关系型数据库、Redis缓存、MinIO/OSS文件存储、MongoDB等

3.3 微服务架构能力

平台支持单体与微服务自由切换，满足不同规模项目需求，核心微服务组件：

• 服务注册与发现、统一配置中心：Nacos
• 路由网关：Gateway（支持三种加载方式）
• 熔断降级限流：Sentinel
• 分布式通信：OpenFeign
• 分布式文件存储：MinIO、阿里OSS
• 统一权限控制：JWT + Shiro
• 服务监控：SpringBootAdmin
• 链路追踪：Skywalking
• 分布式任务：xxl-job
• 分布式事务：Seata
• 容器化支持：docker-compose、k8s、jenkins
• 单点登录：CAS

3.4 数据库与信创兼容

主流数据库兼容

一套代码全兼容，默认提供MySQL脚本，其他数据库可通过官方转库文档适配：

• 关系型数据库：MySQL、Oracle11g、Sqlserver2017、PostgreSQL、MariaDB
• 国产化数据库：达梦、人大金仓、TiDB、kingbase8

全信创环境适配

• 操作系统：国产麒麟、银河麒麟等基于Linux内核的国产系统
• 中间件：东方通 TongWeb/TongRDS、宝兰德 AppServer/CacheDB
• 完整适配信创生态，为国产化环境提供高效开发解决方案

四、核心低代码能力（平台核心，精通必备）

4.1 Online在线开发（零代码核心）

Online模块是平台零代码能力的核心，无需编码，通过可视化配置即可完成全功能开发，核心能力：

1. Online在线表单
   • 无需编码，在线配置表单，实现增删改查全功能
   • 支持单表、树、一对多、一对一等数据模型
   • 内置23种控件，支持字段校验、权限控制、布局自定义
   • 支持AI建表，通过自然语言快速生成表单模型
2. Online在线报表
   • 零代码在线配置数据报表、图形报表，快速抽取业务数据
   • 支持主子表关联查询、高级组合查询，可保存查询历史
   • 查询过滤器自动生成，后台动态拼接SQL，支持全匹配、模糊查询、包含查询等多种匹配方式
3. Online在线增强
   • 内置在线代码编辑器，支持代码高亮、代码提示
   • 支持Java、SQL、JavaScript等多语言在线编写，实现业务逻辑自定义
4. 配套能力：仪表盘设计器、系统编码规则、系统校验规则，全流程零代码闭环

4.2 代码生成器（低代码核心）

平台核心效率工具，一键生成前后端代码，大幅降低重复开发工作量：

1. 核心能力
   • 支持单表、树列表、一对多、一对一等多种数据模型
   • 增删改查、导入导出、权限控制、页面校验等功能一键生成，菜单配置直接使用
2. 模板机制
   • 强大的自定义模板体系，支持用户自定义生成模板
   • 官方默认提供4套风格模板：单表2套、树模型1套、一对多3套
   • 新增uniapp3移动端代码生成器模板，一套代码多端适配
3. 自带能力
   • 生成代码自带Excel导入导出，支持单表、一对多表模式
   • 自动生成页面校验规则（必填、数字、金额、时间区间等）
   • 自动集成查询过滤器、高级查询器，无需额外编码

4.3 表单设计能力

1. 可视化表单设计器
   • 支持用户自定义表单布局，拖拽式配置，所见即所得
   • 支持单表、一对多表单，内置select、radio、checkbox、textarea、date、popup、列表、宏等丰富控件
   • 支持AI字段建议，通过自然语言快速生成表单字段与配置
   • 支持移动适配、外部填报，表单视图功能（日历、表格、看板、甘特图等）
2. 多表单解决方案：支持表单设计器、online配置表单、编码表单三种模式，适配不同业务复杂度

4.4 流程设计与工作流能力

基于开源Flowable流程引擎打造，实现流程与表单松耦合设计，大幅简化BPM开发：

1. 可视化流程设计
   • 在线画流程、自定义流程转向、流程节点配置
   • 支持会签配置、任务监听、执行监听、全局监听、流程表达式自定义
2. 流程与表单解耦
   • 流程节点可灵活挂靠表单，支持自定义表单、编码表单等多种表单模式
   • 扩展任务接口，支持开发者编写业务逻辑，兼顾标准化与个性化
3. 全流程管理能力
   • 流程实例管理、历史流程、任务管理、我发起的流程、我的抄送
   • 支持流程委派、抄送、跳转、驳回等高级操作
   • 提供简流设计器（类钉钉版），适配轻量化审批场景

4.5 报表与可视化能力

1. 积木报表设计器
   • 内置打印设计器、数据报表设计、图形报表设计（基于ECharts）
   • 支持报表打印、数据导出，一键生成PDF、Excel、Word等格式报表
   • 支持Excel模板导入，多级循环表头、分组报表、横向/纵向报表等复杂报表场景
2. 大屏与仪表盘设计
   • 拖拽式大屏设计器，内置丰富大屏模板，适配作战指挥中心、物流监控等场景
   • 仪表盘设计器，支持自定义门户、自定义系统首页，多种组合模式可选
   • 支持丰富的图表类型：柱形图、折线图、散点图、饼图、环形图、面积图、漏斗图、进度图、仪表盘、雷达图、地图等
3. 高性能表格组件：提供新行编辑表格JVXETable，适配复杂ERP布局，具备更高性能、更灵活的扩展能力

五、系统基础能力（二次开发必备基础）

5.1 RBAC权限体系

平台采用基于角色的访问控制（RBAC） 模型，实现精细化权限管控：

1. 功能权限：菜单权限、按钮权限，支持不同角色分配不同操作权限
2. 数据权限：精细化控制到行级、列表级、表单字段级，实现不同人看不同数据、不同人操作不同字段
3. 表单权限：控制字段禁用、隐藏，适配不同角色的表单操作场景
4. 接口权限：细化接口授权控制，基于AK/SK认证鉴权的OpenAPI能力，实现不同客户端的接口访问管控
5. 多租户权限：完整的SaaS多租户架构，支持租户管理、租户角色、租户数据隔离

5.2 系统管理核心模块

平台内置完善的系统管理能力，开箱即用，无需重复开发：

• 组织架构：用户管理、角色管理、部门管理、职务管理、通讯录
• 基础配置：菜单管理、字典管理、分类字典、系统公告、多数据源管理
• 二级管理员：我的部门管理，支持分级权限管控
• 多租户管理：租户管理、租户角色、我的租户，完整SaaS能力

5.3 通用工具与集成能力

平台封装了大量通用工具，覆盖80%以上的项目通用需求：

1. 通用工具类：定时任务、短信接口、邮件发送、Excel导入导出、文件上传管理
2. 文件存储：集成MinIO、阿里OSS，同时支持本地存储，分布式文件服务
3. 消息中心：支持短信、邮件、微信推送，集成WebSocket消息通知机制
4. 国际化：支持多语言，提供完整的国际化方案
5. 数据日志：记录数据每次变更内容，支持版本对比查看历史变化
6. 在线接口文档：集成Swagger-UI，统一RESTful接口规范，JWT token安全验证
7. 打印插件：简单易用，兼容谷歌、火狐、IE11+等主流浏览器

5.4 系统监控能力

全维度系统监控，实时跟踪系统运行状态：

• 性能监控：Redis、Tomcat、JVM、服务器信息、磁盘监控
• 请求追踪：全链路请求耗时监控、SQL监控
• 定时任务：在线配置、管理定时任务，支持cron表达式在线生成
• 系统日志：系统操作日志、数据变更日志、登录日志全记录
• 服务监控：SpringBootAdmin服务监控、Skywalking全链路追踪

六、AI赋能低代码（平台核心特色）

6.1 AI平台整体定位

JeecgBoot内置一套完善的AI应用管理系统，是类似Dify的AIGC应用开发平台 + RAG知识库问答系统，基于LLM大语言模型与RAG检索增强技术，帮助企业快速从原型到生产，落地AI服务能力。

6.2 核心AI能力

1. AI低代码全流程赋能
   • AI建表：通过自然语言一键生成Online表单与表结构
   • AI字段建议：表单设计器中通过AI快速生成字段配置与规则
   • AI写文章：内置CMS内容生成能力
   • AI报表：自然语言生成报表配置与查询SQL
2. AI对话与应用能力
   • AI对话助手：智能问答，支持图片理解，聊天窗口支持嵌入第三方、适配移动端
   • AI知识库问答系统：基于RAG的知识库管理，实现企业私有数据问答
   • AI流程编排与设计器：可视化编排AI工作流，实现复杂AI业务场景
   • AI OCR示例：内置文字识别能力
3. AI模型管理
   • 支持主流大模型：ChatGPT、DeepSeek、Ollama、智谱AI、通义千问等
   • 最新版默认使用DeepSeek大模型，兼顾速度与生成质量
   • 支持模型切换、模型配置管理，适配不同业务场景

七、进阶开发与二次开发（精通核心）

7.1 单体与微服务无缝切换

平台提供简易切换机制，一套代码同时支持单体与微服务架构：

• 中小项目：使用单体架构，部署简单、维护成本低
• 中大型项目：切换为微服务架构，支持分布式部署、水平扩展
• 官方提供Docker一键启动微服务前后端方案，降低部署难度

7.2 自定义业务开发

1. 代码生成+手工Merge模式
   • 基础增删改查功能通过代码生成器一键生成
   • 复杂业务逻辑在生成代码基础上进行手工扩展，不影响基础功能的迭代升级
   • 避免重复开发，同时保证业务逻辑的灵活性
2. Online在线增强开发
   • 零代码场景下，通过在线Java、JS、SQL编写，实现业务逻辑自定义
   • 支持表单事件、数据校验、业务钩子、接口扩展等场景
3. 自定义前后端组件
   • 前端：基于Vue3组件规范，自定义业务组件，集成到表单设计器与Online表单中
   • 后端：基于Spring Boot规范，自定义业务模块、工具类、接口，复用平台基础能力

7.3 工作流进阶开发

• 自定义任务接口：在流程节点中开发自定义业务逻辑，实现流程与业务深度集成
• 流程监听：执行监听、任务监听，实现流程节点的前置/后置业务处理
• 流程表达式：自定义流程条件表达式，实现复杂的流程分支流转规则
• 流程权限：自定义审批人规则、审批权限管控，适配企业复杂的组织架构与审批流程

7.4 高级集成能力

1. 多数据源集成：在线配置数据源，便捷从其他数据库抓取数据，支持跨库查询与报表开发
2. 单点登录集成：官方提供CAS单点登录集成方案，完善的对接代码，快速对接企业统一身份体系
3. 第三方系统对接：基于RESTful接口规范与OpenAPI能力，快速对接第三方业务系统
4. 物联网集成：支持MQTT协议，适配物联网设备数据接入与业务开发

八、全端适配能力

8.1 移动端全平台适配

平台提供成熟的移动端解决方案，一份代码多终端适配，覆盖：小程序、H5、安卓、iOS、鸿蒙Next。

• 新版APP框架技术栈：Uniapp、Vue3.0、Vite、Wot-design-uni、TypeScript
• 核心能力：二次封装组件、路由拦截、请求拦截，与JeecgBoot后端完美对接
• 内置功能：登录、用户信息、通讯录、公告、移动首页、九宫格、聊天、Online表单、仪表盘
• 低代码支持：移动端Online表单、仪表盘低代码设计，零代码生成移动端页面

8.2 桌面端适配

支持electron桌面应用打包，兼容Windows、Linux、macOS三大桌面平台，快速将Web系统打包为桌面客户端。

九、部署与运维（上线必备）

9.1 部署方案

1. 传统部署：手动部署前后端项目，适配Linux、Windows服务器
2. 容器化部署：Docker一键部署，官方提供docker-compose编排文件，快速搭建单机/集群环境
3. 云原生部署：支持K8s容器编排、Jenkins自动化CI/CD，适配企业级云原生环境

9.2 运维与监控

1. 系统监控：内置Redis、Tomcat、JVM、服务器、磁盘监控，实时掌握系统运行状态
2. 链路追踪：集成Skywalking，实现全链路请求追踪、性能瓶颈定位
3. 日志管理：支持轻量分布式日志Loki+grafana套件，集中化日志收集、查询、分析
4. 安全运维：接口限流、防刷机制，数据权限隔离，定期安全更新与漏洞修复

9.3 安全机制

• 身份认证：JWT + Shiro安全认证体系，支持多因素认证
• 数据安全：数据权限隔离、数据变更日志、数据加密存储
• 接口安全：接口鉴权、AK/SK认证、接口限流、防刷机制
• 代码安全：输入校验、SQL注入防护、XSS攻击防护
• 官方团队持续维护安全更新，修复已知漏洞，提供全面的安全解决方案

十、版本差异与生态支持

10.1 开源版与企业版核心差异

维度	开源版	企业版
核心协议	Apache-2.0，可商用	商业授权，提供官方技术支持
低代码能力	Online表单、基础代码生成、基础报表	全量Online模块源码、表单设计器全功能、零代码应用管理
流程能力	基础流程设计与引擎	全量流程监控、流程设计器、简流设计器、OA办公组件、流程全生命周期管理
可视化能力	基础报表、基础图表	积木报表企业版、大屏设计器全功能、门户设计、表单视图全类型
AI能力	基础AI对话、AI建表	AI流程设计器源码、AI字段建议、AI写文章、全量AI应用能力
其他能力	基础系统管理、基础多端适配	商业APP、在线聊天、外部填报、移动适配全功能

10.2 产品生态

• 敲敲云零代码平台：Jeecg团队研发的零代码产品，与JeecgBoot低代码平台形成互补，满足从简单业务到复杂系统的全场景开发需求
• 积木报表：开源报表工具，JeecgBoot内置，可独立使用，满足企业级报表需求
• 活跃的社区生态：官方文档、视频教程、交流群、技术博客，持续更新迭代

十一、从入门到精通的最佳实践

11.1 入门阶段（1-2周）

1. 完成环境搭建，成功启动前后端项目，熟悉系统整体界面与菜单
2. 体验Online表单功能，零代码完成一个单表的增删改查功能
3. 使用代码生成器，基于数据库表生成前后端代码，完成菜单配置与功能测试
4. 熟悉系统管理模块，掌握用户、角色、权限、字典的基础配置

11.2 进阶阶段（2-4周）

1. 掌握表单设计器的使用，完成一对多复杂表单的配置与业务开发
2. 学习流程设计器，完成一个完整的审批流程（请假/出差/报销）的配置与测试
3. 掌握积木报表与大屏设计，完成一个业务报表与可视化大屏的开发
4. 学习二次开发模式，基于代码生成器完成复杂业务逻辑的自定义开发
5. 熟悉平台权限体系，实现精细化的按钮权限与数据权限配置

11.3 精通阶段（1个月以上）

1. 掌握AI低代码全流程应用，实现AI建表、AI流程编排、知识库问答的落地
2. 掌握单体与微服务切换，完成微服务架构的项目搭建与部署
3. 掌握自定义组件开发，实现前后端自定义组件的封装与平台集成
4. 掌握工作流深度开发，实现流程与业务系统的深度集成
5. 完成信创环境适配，实现国产化系统的部署与运行
6. 掌握云原生部署，完成K8s环境下的集群部署、监控与运维

11.4 避坑指南

1. 环境版本必须严格匹配，尤其是Node.js、JDK版本，避免出现兼容性问题
2. 二次开发优先使用「代码生成+手工Merge」模式，避免直接修改平台底层源码，影响后续版本升级
3. 复杂业务流程优先做好表单与流程的解耦设计，避免强耦合导致的后续维护困难
4. 生产环境必须做好权限管控、数据备份、接口安全配置，避免安全风险
5. 优先使用官方提供的封装工具与组件，避免重复造轮子，同时保证系统稳定性