JeecgBoot 项目运行指南
根据分析,这是一个基于 Spring Boot 3 和 Vue 3 的前后端分离企业级低代码平台。以下是完整的运行步骤:
一、环境准备
1. 必需软件安装
- JDK 17 ✓(您已安装)
- MySQL 8.0 ✓(您已安装)
- Node.js 16+(前端开发)
- Redis(缓存服务)
- Maven(项目构建)
2. 可选工具
- Nginx(反向代理)
- Git(版本控制)
二、数据库配置
1. 创建数据库
sql
CREATE DATABASE IF NOT EXISTS `jeecg-boot`
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
2. 导入初始化脚本
执行文件:
jeecg-boot/db/jeecgboot-mysql-5.7.sql
3. 修改数据库连接
配置文件:
jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml
yaml
spring:
datasource:
dynamic:
datasource:
master:
url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?useSSL=false&serverTimezone=Asia/Shanghai
username: root # 修改为实际用户名
password: root # 修改为实际密码
driver-class-name: com.mysql.cj.jdbc.Driver
三、后端启动
1. IDE 启动(推荐)
- 导入 Maven 项目
- 识别根目录
pom.xml - 运行主类:
org.jeecg.JeecgSystemApplication
2. 命令行启动
bash
cd jeecg-boot
mvn clean install -DskipTests
cd jeecg-module-system/jeecg-system-start
mvn spring-boot:run
3. 访问配置
- 端口:8080
- 访问路径:
http://localhost:8080/jeecg-boot
四、前端启动
1. 安装依赖
bash
cd jeecgboot-vue3
npm install # 或 pnpm install
2. 启动服务
bash
npm run dev
3. 访问路径
- 端口:3100
- 地址:
http://localhost:3100
五、系统配置
1. Redis 配置
修改 application-dev.yml:
yaml
spring:
data:
redis:
host: 127.0.0.1
port: 6379
password: # 如有密码请填写
2. 默认凭证
- 用户名:admin
- 密码:123456
六、注意事项
-
初始化:首次启动自动创建系统表
-
跨域处理:前后端分离需配置 CORS
-
端口冲突 :可通过配置文件修改
- 后端:
server.port - 前端:
vite.config.ts
- 后端:
-
JVM 配置 :建议参数
-Xms512m -Xmx2g
七、扩展功能
按需配置:
- 文件存储:MinIO/OSS
- 定时任务:XXL-Job
- 模型服务:AI 接口配置
- 消息服务:短信平台集成
提示:启动顺序建议 数据库 → Redis → 后端 → 前端