JeecgBoot 低代码平台 30 分钟跑通:代码生成器让 CRUD 不再手敲
做管理后台最磨人的不是业务逻辑,而是"建表 → 实体 → Mapper → Service → Controller → 列表页 → 表单页"这条重复流水线。JeecgBoot 是一个 Java 企业级低代码平台,主打代码生成器:导入一张表就能产出整套前后端增删改查代码,还内置在线表单、流程设计、报表大屏和一整套 AI 应用平台。这篇文章的目标很具体:30 分钟之内,在你电脑上把这个低代码平台从零搭到"能登录、能生成代码"的状态。
🎯 跑通之后你手里有什么
按本文走完后,你会得到一个完整可用的 JeecgBoot 开发环境:
- 浏览器里可登录的低代码平台(默认账号
admin/123456) - 可用的代码生成器:导入业务表 → 下载整套前后端代码 → 合入项目即可用
- 在线表单设计、流程设计器、报表大屏这些"平台能力"随时可体验
- 一套可以继续长业务代码的工程骨架,而不是一个演示页面
仓库就两个大目录,先建立心智模型:jeecg-boot(Java 后端,Maven 多模块,单体启动模块是 jeecg-module-system/jeecg-system-start,AI 功能在 jeecg-boot-module/jeecg-boot-module-airag)、jeecgboot-vue3(Vue3 + Vite + Ant Design 前端)。
📋 开工前的环境清单
动手前对照检查一遍,缺什么补什么,这是本文唯一可能卡壳的地方:
- JDK 17(根
pom.xml声明<java.version>17</java.version>,8/11 不行) - Maven 3.6+
- MySQL 5.7+(或 8.0,下文按 5.7 演示)
- Node.js 18+
- Redis(登录态依赖它,本机默认
127.0.0.1:6379即可) - Git
第 1 步 · 把代码拉到本地
git clone https://gitcode.com/GitHub_Trending/je/jeecg-boot
执行后当前目录出现 jeecg-boot(后端)和 jeecgboot-vue3(前端)两个文件夹,说明拉取成功。
第 2 步 · 导入数据库脚本建库
在 MySQL 客户端执行仓库自带的初始化脚本 jeecg-boot/db/jeecgboot-mysql-5.7.sql。它会自动创建 jeecg-boot 库并写入系统表,执行完成后:
- 库里表数量超过 100 张(
sys_user、sys_role、sys_permission……) - 默认管理员账号
admin(密码123456)已就位,登录时直接用
第 3 步 · 数据库配置改哪几行
打开 jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml,只需要核对 spring.datasource.dynamic.datasource.master 这一段:
master:
url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8&useUnicode=true&useSSL=false&tinyInt1isBit=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
username: root
password: root
- 把你本地 MySQL 的用户名、密码填进去,主机、端口、库名
jeecg-boot保持一致 - 下方
spring.data.redis默认指向127.0.0.1:6379且密码为空,本地裸装 Redis 的话不用动
改完后保存。如果第 4 步启动时日志出现 Communications link failure,99% 是这一处没配对。
第 4 步 · 后端构建与启动
先构建,再启动,两条命令:
cd jeecg-boot
mvn clean install -DskipTests
全部模块输出 BUILD SUCCESS 即构建完成(首次会下载依赖,耗时取决于网速)。
然后在 IDE 里运行启动类 jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java 的 main 方法(或命令行 mvn spring-boot:run -pl jeecg-module-system/jeecg-system-start)。日志里同时出现这两句才算启动成功:
Started JeecgSystemApplication in xx.xx secondsTomcat started on port 8080
此时用浏览器访问 http://localhost:8080/jeecg-boot/sys/login,能看到 JSON 格式的接口响应(提示 token 之类),说明后端 API 已通。
第 5 步 · 前端一键启动
cd jeecgboot-vue3
pnpm install
pnpm dev
pnpm install装完依赖不报红即可(习惯 npm 的话npm install也可,但本项目锁文件是 pnpm 系,推荐 pnpm)pnpm dev启动 Vite 开发服务器,终端打印本地地址后,浏览器打开http://localhost:3100,输入admin/123456登录
登录成功、左侧菜单正常加载,前后端就算接通了——前端通过 .env.development 里的 VITE_PROXY 把 /jeecgboot 代理到 http://localhost:8080/jeecg-boot,跨域问题不用你操心。
✅ 效果检验:三个 5 分钟体验
登录后别急着写业务,先花 15 分钟验证平台能力,确认你搭的是"平台"而不是"空壳":
- 在线表单:进入"系统管理 → 表单管理(在线表单)",拖字段设计一个"请假申请"页,保存发布后用账号打开链接,能正常填写提交即验证通过。
- 流程设计:进入"流程设计",画一条最简单的
发起 → 经理审批 → 结束流程并保存,设计器能回显三个节点即通过。 - 代码生成器:进入"代码生成 → 一键生成",选一张系统表(如
sys_depart),预览生成的 Controller / Service / Vue 页面,点生成下载 zip。解压看看——这就是"解决重复工作"的具体形态。
数据可视化也内置了。打开"大屏管理"能看到两套官方模板,第二套模板的效果如下:
第一套模板的指挥中心风格底图,适合做值班室、调度室这类场景的大屏背景:
🔍 常见坑速查表
| 现象 | 原因 | 处理办法 |
|---|---|---|
启动报 Port 8080 was already in use | 端口被占用 | 把 application-dev.yml 的 server.port 改成 8081,同时把 .env.development 里 VITE_PROXY、VITE_GLOB_DOMAIN_URL 的地址同步改掉 |
日志刷 Communications link failure | 数据库连不上 | 核对第 3 步的 url/username/password;确认 MySQL 进程在跑:mysql -uroot -p 能进库才算数 |
| 登录报 Redis 相关异常 | 没起 Redis | 本机启动 Redis 或把 yml 里 spring.data.redis 指向可用的实例 |
| 前端装依赖报 peer 冲突 | 包管理器不一致 | 删掉 node_modules,统一用 pnpm install 重装 |
| Flyway 迁移失败 | 初始化脚本没导全 | 删库后重新执行 jeecgboot-mysql-5.7.sql,再重启后端 |
| 页面白屏、接口 404 | 前后端没对上 | 确认后端 8080 已起、.env.development 中代理地址没被改动 |
🚀 下一步往哪走
- 玩 AI 能力:
jeecg-boot/jeecg-boot-module/jeecg-boot-module-airag内置 AI 聊天、知识库、流程编排、MCP 插件,登录后在"AI 应用平台"里给模型配一个 API Key 就能开聊。 - 切微服务形态:仓库自带
jeecg-boot/jeecg-server-cloud(Gateway、Nacos、XxlJob 等),服务间配置样例在jeecg-boot/jeecg-server-cloud/jeecg-cloud-nacos/docs/DEFAULT_GROUP/,单体跑稳后再上微服务不迟。 - 部署到内网:把前端
.env.development里的VITE_GLOB_DOMAIN_URL指向内网后端地址,pnpm build产出静态文件交给 Nginx,再按server.port映射到内网端口即可——把端口改成 8080 部署到内网,就是你要的下一步。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考







