JeeLowCode：企业级低代码平台从零到一部署指南

一、价值定位：低代码开发框架的企业级应用价值

JeeLowCode作为基于Spring Boot 2.7.18和Vue 3.2构建的企业级低代码开发框架，以Apache 2.0开源协议为基础，为企业应用开发提供了高效解决方案。其核心价值体现在三个维度：首先，可视化表构建功能允许开发者在线创建数据表并自动生成CRUD（创建、读取、更新、删除）功能，将传统开发流程缩短60%以上；其次，多租户数据权限设计实现了精细的租户级数据隔离，满足企业级SaaS应用的核心需求；最后，100+常用页面模板和多数据库兼容能力（MySQL/Oracle/PostgreSQL/达梦等），为跨平台部署提供了灵活支撑。本指南将系统讲解如何从零开始部署这套企业级低代码平台，帮助团队快速实现应用搭建。

二、环境适配：基础依赖与工具链配置

2.1 基础依赖清单

组件	最低版本要求	推荐版本	兼容性说明
JDK	1.8+	1.8.0_301	需配置JAVA_HOME环境变量
Maven	3.6+	3.8.6	建议使用3.8.x版本避免依赖问题
Node.js	16.x	16.19.1	前端构建核心依赖
MySQL	5.7+	8.0.31	需开启innodb引擎
Redis	5.0+	6.2.7	用于缓存和分布式锁

2.2 工具链适配指南

开发环境验证脚本

# 环境检测脚本（Linux/macOS）
echo "=== 环境检测 ==="
java -version && mvn -v && node -v && npm -v && mysql --version && redis-cli --version

# Windows环境
# java -version; mvn -v; node -v; npm -v; mysql --version; redis-cli --version

✅ 验证标准：所有命令均能正常输出版本信息，无报错提示

⚠️ 注意事项：

• Windows用户需确保所有工具已添加至系统PATH
• macOS用户建议通过Homebrew安装依赖包
• Linux用户需注意权限问题，避免使用root用户执行开发命令

三、分步实施：获取与部署全流程

3.1 后端部署

【后端初始化】克隆并配置项目

# 克隆项目代码
git clone https://gitcode.com/jeelowcode/jeelowcode.git
cd jeelowcode

# 导入数据库（需提前创建数据库）
mysql -uroot -p -e "CREATE DATABASE jeelowcode DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -uroot -p jeelowcode < doc/sql/mysql/db_jeelowcode.sql
mysql -uroot -p jeelowcode < doc/sql/mysql/db_jeelowcodelog.sql

验证方法：登录MySQL执行USE jeelowcode; SHOW TABLES;，应显示50+张系统表

【配置调整】修改环境参数

# 编辑配置文件
vim jeelowcode-admin/src/main/resources/application-dev.yml

关键配置项说明：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/jeelowcode?useUnicode=true&characterEncoding=utf8
    username: root
    password: yourpassword  # 修改为实际密码
  redis:
    host: localhost
    port: 6379
    password:  # 如无密码留空

✅ 验证方法：通过cat命令检查配置文件修改是否生效

【编译运行】构建并启动服务

# 编译项目
mvn clean install -DskipTests

# 启动服务
cd jeelowcode-admin
mvn spring-boot:run

验证方法：访问http://localhost:8080，应看到系统登录页面

3.2 前端部署

【前端初始化】获取并安装依赖

# 克隆前端项目
git clone https://gitcode.com/jeelowcode/jeelowcode-ui-admin-vue3.git
cd jeelowcode-ui-admin-vue3

# 安装依赖
npm install

⚠️ 注意事项：

• 如遇依赖安装失败，可尝试使用npm install --registry=https://registry.npm.taobao.org
• Windows用户可能需要安装windows-build-tools：npm install --global --production windows-build-tools

【开发环境启动】运行前端服务

# 启动开发服务器
npm run dev

验证方法：浏览器访问http://localhost:80（默认端口），应显示系统登录界面

四、场景拓展：多环境部署与优化

4.1 生产环境构建

# 后端打包
cd jeelowcode
mvn package -DskipTests

# 前端构建
cd jeelowcode-ui-admin-vue3
npm run build:prod

4.2 多数据库适配方案

数据库类型	配置调整点	初始化脚本
MySQL	默认配置	db_jeelowcode.sql
Oracle	修改驱动类和URL格式	需联系官方获取
PostgreSQL	修改方言配置	需联系官方获取
达梦	使用db_jeelowcode_dm.sql	db_jeelowcode_dm.sql

五、常见问题速查

Q1: 启动时报数据库连接错误？

A: 检查：1. MySQL服务是否启动 2. 数据库用户名密码是否正确 3. 数据库是否已创建 4. 防火墙是否开放3306端口

Q2: 前端启动后无法访问后端接口？

A: 确认jeelowcode-admin/src/main/resources/application-dev.yml中的server.port是否为8080，或修改前端.env.development中的VUE_APP_BASE_API配置

Q3: Maven编译报依赖下载失败？

A: 尝试清除Maven缓存：mvn clean install -U，或检查settings.xml中的镜像配置

Q4: 导入数据库时报语法错误？

A: 确认MySQL版本是否符合要求，低版本可能不支持某些语法，建议使用8.0+版本

Q5: 服务启动成功但无法访问？

A: 检查：1. 端口是否被占用 2. 防火墙设置 3. application.yml中的server.address是否设为0.0.0.0