JeecgBoot开发环境搭建与调试

JeecgBoot开发环境搭建与调试

【免费下载链接】jeecg-boot jeecgboot/jeecg-boot 是一个基于 Spring Boot 的 Java 框架，用于快速开发企业级应用。适合在 Java 应用开发中使用，提高开发效率和代码质量。特点是提供了丰富的组件库、模块化架构和自动化配置方式。 项目地址: https://gitcode.com/GitHub_Trending/je/jeecg-boot

本文详细介绍了JeecgBoot企业级AI低代码平台的开发环境搭建与调试过程，涵盖了开发工具与环境要求配置、前后端项目启动与联调、常见问题排查与解决方案以及性能优化与监控配置等核心内容。文章提供了从基础环境搭建到高级性能优化的完整指南，包括详细的版本要求、配置示例和最佳实践，帮助开发者快速构建稳定高效的开发环境。

开发工具与环境要求配置

JeecgBoot作为一款企业级AI低代码平台，对开发环境有着明确的要求。为了确保开发过程的顺利进行，开发者需要配置合适的开发工具和环境。本节将详细介绍JeecgBoot开发所需的各种工具、软件版本要求以及环境配置细节。

开发工具要求

后端开发工具

IntelliJ IDEA (推荐)

• 版本要求：2021.3+ 版本
• 必备插件：Lombok Plugin
• 配置要求：至少8GB内存，建议16GB以上
• 其他可选插件：Maven Helper、MyBatisX、GitToolBox

Eclipse (可选)

• 版本要求：Eclipse 2020-06+
• 需要安装Spring Tools Suite插件
• 配置Lombok支持

Visual Studio Code (前端专用)

• 版本要求：1.60+
• 推荐插件：Volar、TypeScript Vue Plugin、ESLint

数据库管理工具

工具名称	推荐版本	主要用途
Navicat Premium	15+	MySQL/PostgreSQL管理
DBeaver	社区版	多数据库支持
MySQL Workbench	8.0+	MySQL专用管理
pgAdmin	4+	PostgreSQL管理

其他辅助工具

• Postman：API接口测试，版本10+
• Redis Desktop Manager：Redis可视化管理
• Docker Desktop：容器化部署和开发
• Git：版本控制，版本2.30+

环境版本要求

后端环境要求

详细版本要求表：

组件	最低版本	推荐版本	备注
JDK	17	17或21	支持JDK8但推荐17
Maven	3.6	3.8+	需要配置阿里云镜像
MySQL	5.7	8.0	字符集utf8mb4
Redis	5.0	7.0	支持集群模式
PostgreSQL	12	15	用于向量数据库

前端环境要求

前端详细版本要求：

组件	最低版本	推荐版本	说明
Node.js	18	20+	LTS版本
PNPM	8	9+	包管理器
Vue	3.2	3.3+	组合式API
TypeScript	4.9	5.0+	类型安全
Vite	4	6+	构建工具

数据库配置要求

MySQL数据库配置

# application-dev.yml 数据库配置示例
spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
          username: root
          password: root
          driver-class-name: com.mysql.cj.jdbc.Driver

MySQL重要参数配置：

-- 创建数据库时指定字符集
CREATE DATABASE `jeecg-boot` 
DEFAULT CHARACTER SET utf8mb4 
COLLATE utf8mb4_unicode_ci;

-- 重要系统参数
SET GLOBAL max_connections = 1000;
SET GLOBAL innodb_buffer_pool_size = 1G;
SET GLOBAL wait_timeout = 28800;

Redis配置要求

spring:
  redis:
    database: 0
    host: 127.0.0.1
    port: 6379
    password: ''
    timeout: 3000ms
    lettuce:
      pool:
        max-active: 200
        max-wait: -1ms
        max-idle: 10
        min-idle: 0

AI功能环境要求

向量数据库配置

jeecg:
  ai-rag:
    embed-store:
      host: 127.0.0.1
      port: 5432
      database: postgres
      user: postgres
      password: postgres
      table: embeddings

PostgreSQL with pgvector扩展：

-- 安装pgvector扩展
CREATE EXTENSION IF NOT EXISTS vector;

-- 创建向量表
CREATE TABLE embeddings (
    id BIGSERIAL PRIMARY KEY,
    vector vector(1536),
    content TEXT,
    metadata JSONB
);

AI模型服务配置

jeecg:
  ai-chat:
    enabled: true
    model: deepseek-chat
    apiKey: your-api-key-here
    apiHost: https://api.deepseek.com/v1
    timeout: 60

支持的AI模型提供商：

• DeepSeek Chat
• OpenAI GPT系列
• 智谱AI (ZHIPU)
• 其他兼容OpenAI API的模型

开发环境检查脚本

JeecgBoot提供了环境检查脚本，可以快速验证开发环境：

# 运行环境检查
python check_jeecgenv.py

# 或者直接执行
./check_jeecgenv.py

检查项目包括：

• ✅ JDK 17+ 版本验证
• ✅ Maven 安装验证
• ✅ Node.js 20+ 版本验证
• ✅ PNPM 9+ 版本验证
• ✅ Redis 连接配置检查
• ✅ MySQL 连接配置检查
• ✅ AI功能配置检查

性能优化建议

开发机硬件建议

组件	最低配置	推荐配置	生产环境
CPU	4核	8核	16核+
内存	8GB	16GB	32GB+
磁盘	SSD 256GB	SSD 512GB	SSD 1TB+

JVM参数优化

# 开发环境JVM参数
-Xms2g -Xmx4g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m

# 生产环境JVM参数  
-Xms4g -Xmx8g -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=1g

前端构建优化

// vite.config.ts 优化配置
build: {
  minify: 'esbuild',
  target: 'es2015',
  chunkSizeWarningLimit: 2000,
  rollupOptions: {
    treeshake: false, // 关闭除屑优化
    output: {
      manualChunks: {
        'vue-vendor': ['vue', 'vue-router'],
        'antd-vue-vendor': ['ant-design-vue']
      }
    }
  }
}

常见环境问题解决

端口冲突解决

JeecgBoot默认使用以下端口，如遇冲突需要修改：

服务	默认端口	配置文件位置
后端服务	8080	application-dev.yml
前端服务	3100	.env.development
MySQL	3306	docker-compose.yml
Redis	6379	docker-compose.yml

依赖下载问题

配置Maven阿里云镜像加速：

<!-- settings.xml 配置 -->
<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

前端依赖安装

# 使用PNPM安装依赖（推荐）
pnpm install

# 或者使用npm
npm install

# 清除缓存重新安装
pnpm clean:cache && pnpm install

通过以上详细的开发工具和环境要求配置，开发者可以快速搭建起JeecgBoot的开发环境，为后续的开发和调试工作奠定坚实的基础。正确的环境配置不仅能提高开发效率，还能避免很多常见的运行时问题。

前后端项目启动与联调

JeecgBoot作为一款优秀的企业级低代码开发平台，其前后端分离架构为开发者提供了极大的便利。在完成基础环境配置后，前后端项目的启动与联调是项目开发的关键环节。本节将详细介绍JeecgBoot前后端项目的启动流程、配置要点以及联调技巧。

后端项目启动配置

后端项目基于Spring Boot 2.7.18构建，采用Maven进行依赖管理。启动前需要重点关注application-dev.yml配置文件中的关键配置项：

server:
  port: 8080
  servlet:
    context-path: /jeecg-boot

spring:
  datasource:
    druid:
      dynamic:
        datasource:
          master:
            url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8
            username: root
            password: root
            driver-class-name: com.mysql.cj.jdbc.Driver

  redis:
    host: 127.0.0.1
    port: 6379
    password: ''

jeecg:
  domainUrl:
    pc: http://localhost:3100
    app: http://localhost:8051

关键配置说明：

• 数据库连接：确保MySQL服务运行在3306端口，数据库名为jeecg-boot
• Redis配置：用于缓存和会话管理，默认无密码
• 前端地址：pc端对应Vue3项目运行地址，app端对应移动端地址

前端项目启动流程

前端项目采用Vue3 + TypeScript + Vite6技术栈，启动前需要安装依赖并配置环境：

# 进入前端项目目录
cd jeecgboot-vue3

# 安装依赖（推荐使用pnpm）
pnpm install

# 启动开发服务器
pnpm dev

前端项目启动后默认运行在3100端口，访问 http://localhost:3100 即可看到登录界面。

前后端联调配置

为确保前后端正常通信，需要配置代理和跨域设置。在vite.config.ts中配置代理：

export default defineConfig({
  server: {
    port: 3100,
    proxy: {
      '/jeecg-boot': {
        target: 'http://localhost:8080',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/jeecg-boot/, '/jeecg-boot')
      }
    }
  }
})

数据库初始化与数据准备

项目启动前需要初始化数据库结构和基础数据：

-- 创建数据库
CREATE DATABASE `jeecg-boot` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

-- 执行初始化脚本
source /path/to/jeecg-boot/db/jeecgboot-mysql-5.7.sql;

数据库初始化完成后，系统会自动创建以下核心表结构：

服务启动顺序与依赖关系

正确的启动顺序对于项目成功运行至关重要：

常见问题排查与解决

在启动过程中可能会遇到以下常见问题：

1. 数据库连接失败

# 检查MySQL服务状态
systemctl status mysql

# 检查数据库用户权限
mysql -u root -p -e "SHOW GRANTS FOR 'root'@'localhost'"

2. 端口冲突问题

# 检查端口占用情况
lsof -i :8080
lsof -i :3100

# 终止占用进程
kill -9 <PID>

3. 依赖安装失败

# 清理缓存重新安装
rm -rf node_modules package-lock.json
pnpm install --force

联调测试与功能验证

启动成功后，通过以下步骤验证系统功能：

1. 登录验证：使用默认账号 admin/123456 登录系统
2. 菜单加载：检查左侧菜单是否正常加载
3. 权限验证：测试不同角色的权限控制
4. 接口调试：使用Swagger UI进行API测试

访问Swagger文档：http://localhost:8080/jeecg-boot/doc.html

性能优化建议

对于开发环境，可以进行以下性能优化配置：

# application-dev.yml 性能优化配置
spring:
  main:
    lazy-initialization: true  # 启用懒加载加速启动
  flyway:
    enabled: false            # 开发环境关闭flyway

# 前端vite配置优化
export default defineConfig({
  optimizeDeps: {
    include: ['lodash-es', 'ant-design-vue']
  }
})

监控与日志查看

启动后可以通过以下方式监控系统运行状态：

# 查看后端日志
tail -f jeecg-boot/logs/jeecg-boot.log

# 查看前端构建输出
在浏览器开发者工具中查看网络请求和console输出

# 访问Druid监控
http://localhost:8080/jeecg-boot/druid/index.html

通过以上详细的启动和联调指南，开发者可以快速搭建JeecgBoot开发环境，并进行高效的前后端协同开发。正确的配置和启动顺序是项目成功运行的基础，而细致的监控和问题排查能力则是保证开发效率的关键。

常见问题排查与解决方案

在JeecgBoot开发环境搭建与调试过程中，开发者可能会遇到各种技术问题。本节将系统性地梳理常见问题及其解决方案，帮助开发者快速定位和解决问题。

数据库连接问题

数据库连接是JeecgBoot项目启动时最常见的故障点，主要表现为连接超时、认证失败或数据库不存在等错误。

问题表现

• java.sql.SQLException: Access denied for user 'root'@'localhost'
• Communications link failure
• Unknown database 'jeecg-boot'

解决方案

1. 数据库配置检查

spring:
  datasource:
    druid:
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/jeecg-boot?characterEncoding=UTF-8&useUnicode=true&useSSL=false
          username: root
          password: root
          driver-class-name: com.mysql.cj.jdbc.Driver

2. 数据库初始化流程

3. 常见配置错误表

错误类型	症状	解决方案
端口错误	Connection refused	确认MySQL服务运行在3306端口
密码错误	Access denied	检查application-dev.yml中的密码配置
数据库不存在	Unknown database	手动创建jeecg-boot数据库
SSL配置错误	SSL connection error	在URL中添加useSSL=false参数

依赖包冲突问题

Maven依赖冲突是Java项目中常见的问题，特别是在集成多个第三方库时。

问题表现

• NoSuchMethodError 或 ClassNotFoundException
• 启动时出现版本冲突警告
• 功能异常但无明确错误信息

解决方案

1. 依赖树分析

# 查看依赖树
mvn dependency:tree -Dincludes=groupId:artifactId

# 检查冲突依赖
mvn dependency:tree -Dverbose -Dincludes=冲突的groupId

2. 排除冲突依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

**3.

【免费下载链接】jeecg-boot jeecgboot/jeecg-boot 是一个基于 Spring Boot 的 Java 框架，用于快速开发企业级应用。适合在 Java 应用开发中使用，提高开发效率和代码质量。特点是提供了丰富的组件库、模块化架构和自动化配置方式。 项目地址: https://gitcode.com/GitHub_Trending/je/jeecg-boot