JeecgBoot 入门教程:5 分钟搭建一套可上线的企业级低代码系统
【免费下载链接】jeecg-boot【低代码v2.0,一句话即可生成整个系统】企业级AI低代码平台,一键生成前后端代码甚至整个系统。 AI Skills 一句话画流程、设计表单、生成报表、大屏。内置 AI应用平台涵盖:AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领AI低代码「Skills 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,解决 Java 项目 90% 重复工作,提高效率又不失灵活。项目地址: https://gitcode.com/GitHub_Trending/je/jeecg-boot
JeecgBoot 是一款 Java 企业级 AI 低代码平台,一句话生成前后端代码、表单和流程,内置代码生成器、工作流、报表大屏与 AI 应用平台。读完本文,你能从零启动它、跑通一个完整业务场景,并把它部署到生产环境。
一、它替你省掉什么
写一个"用户管理"模块,传统做法是:建表、写实体类、Mapper、Service、Controller、前端页面、菜单配置,一天时间基本就花完了。JeecgBoot 把这些动作压缩成"配置表结构 → 点生成 → 合并代码",官方给出的口径是覆盖 Java 项目约 80% 的重复工作;简单模块则可以直接用零代码模式在线配置,不写一行代码。
技术上它是标准前后端分离:后端 Spring Boot 4 + MyBatis-Plus + Shiro/JWT,前端 Vue3 + TypeScript + Vite6 + Ant Design Vue4,数据库默认 MySQL,另支持 Oracle、达梦、人大金仓等。
二、最小路径跑通
1. 准备环境:JDK 17、Maven、MySQL 5.7+、Redis,前端需要 Node 20+ 和 pnpm 9+。
2. 导入数据库:拿到代码后,把 db/jeecgboot-mysql-5.7.sql 导入 MySQL,这是基础表结构。
3. 启动后端(端口 8080,上下文路径/jeecg-boot):
cd jeecg-boot/jeecg-module-system/jeecg-system-start mvn spring-boot:run4. 启动前端:进入 jeecgboot-vue3/ 目录,执行pnpm install再执行pnpm dev。开发代理已配好,前端的/jeecgboot请求会自动转发到http://localhost:8080/jeecg-boot,见 .env.development。
5. 验证:浏览器打开前端页面,用默认账号admin/123456登录,能看到用户、角色、菜单等管理页面即成功。
三、挑个场景上手试
1. 一张表生成一整套 CRUD。进入"代码生成器",选择你刚建的表,选一套模板,点生成,后端实体、Controller、Service、Mapper 和前端列表/表单页一次出齐,带 Excel 导入导出,生成后不需要改就能跑。
2. 拖出一张审批流。平台内置 Flowable 工作流引擎,用在线设计器把"提交 → 部门经理 → 总监"这样的节点连起来,再给节点挂上表单,审批流就配完了,业务代码只需在任务接口里补少量逻辑。
3. 拖拽搭一块业务大屏。报表和大屏由内置设计器完成:选数据源、拖图表组件、绑字段,柱状图、折线图、地图等直接可用,不用写 ECharts 代码。仓库里自带两个大屏模板可以直接参考,例如 template1 的效果:
4. 配一个能问答的 AI 助手。AI 应用平台支持模型管理、知识库问答和流程编排,兼容 ChatGPT、DeepSeek、Ollama、千问等主流大模型。配好模型和知识库后,聊天助手可以嵌入到你自己系统的页面里:
四、看懂它的骨架
后端按 Maven 多模块组织,jeecg-boot/ 下三块:
- jeecg-boot-base-core:框架底座,认证(Shiro+JWT)、MyBatis-Plus 配置、公共工具;
- jeecg-module-system/:系统管理,用户、角色、菜单、字典,jeecg-system-start 是启动入口和全部环境配置;
- jeecg-boot-module/:业务功能模块,AI 模块(airag)和示例代码(demo)都在这里。
前端 jeecgboot-vue3/src/ 是标准 Vue3 工程:views/放页面,components/放封装好的表格、表单、上传等组件,菜单和路由由后端接口动态下发。默认是单体部署;需要微服务时加-P SpringCloud参数构建,网关、Nacos、Sentinel 都在 jeecg-server-cloud/ 下。
五、走向生产的进阶
- 多环境:环境配置集中在 jeecg-system-start/src/main/resources/,
application-dev.yml/test/prod/docker按 Maven profile 切换,换环境只改配置不动代码。 - 容器化部署:仓库根目录的 docker-compose.yml 一条命令拉起 MySQL、Redis 和前后端容器,
./start-docker-compose.sh即可,适合快速起测试环境;生产建议前端打成静态包走 Nginx,后端出独立镜像。 - 性能:Redis 缓存和 Druid 连接池默认已接入,调优优先看连接池大小、慢 SQL 日志;高并发微服务形态可启用 Sentinel 限流。
- 团队维护:约定统一的模块命名和提交规范;依赖升级跟随根 pom.xml 集中管理,避免各模块版本漂移;数据库变更走 Flyway 脚本,别手工改线上库。
六、卡住了看这里
- 后端起不来,日志报数据库连接失败→ 检查
application-dev.yml里的地址、账号、密码,以及 MySQL、Redis 服务是否真的在运行; - 前端白屏或接口 404→ 确认后端在
8080端口且上下文路径是/jeecg-boot,再核对 .env.development 里VITE_PROXY的转发目标; pnpm dev报 Node 版本错误→ Vite 要求 Node 20+,用node -v检查,低于 20 先升级;- 登录页转圈进不去→ 多半是数据库脚本没导入完整或 Redis 不可用,后端会话依赖 Redis,两者缺一不可;
- 权限配置不生效→ 先给角色配权限,再把角色分配给用户,顺序反了会漏配。
JeecgBoot 的价值在于把建表到上线之间那 80% 的重复劳动交给了平台,你只需要关注业务本身。现在导入 db/jeecgboot-mysql-5.7.sql、按第二节的四步启动,用半小时挑一个场景试完,比看十篇文档都管用。
【免费下载链接】jeecg-boot【低代码v2.0,一句话即可生成整个系统】企业级AI低代码平台,一键生成前后端代码甚至整个系统。 AI Skills 一句话画流程、设计表单、生成报表、大屏。内置 AI应用平台涵盖:AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领AI低代码「Skills 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,解决 Java 项目 90% 重复工作,提高效率又不失灵活。项目地址: https://gitcode.com/GitHub_Trending/je/jeecg-boot
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考