第一次接触 JeecgBoot 时我花了将近半天时间才把整个环境跑通中间踩的坑大多集中在版本匹配和网络配置上。如果你也正准备从零开始这篇记录应该能帮你省下不少时间。环境准备版本匹配是第一位JeecgBoot 对运行环境有明确要求JDK 推荐 17兼容 8 和 21但 17 是目前最稳定的甜点版本。Node.js 则必须 20 以上因为前端用到了 Vite 6而 Vite 6 依赖 Node 18/20。我第一次图省事用了 Node 16结果pnpm install直接报错提示ERR_PNPM_UNSUPPORTED_ENGINE折腾一圈才发现是版本问题。这里有个容易忽略的点pnpm 版本要 9 以上。可以用pnpm -v快速检查不满足的话用npm install -g pnpmlatest升级即可。组件推荐版本最低要求常见报错JDK178编译失败、Lombok 注解不生效Node.js20.15.020ERR_PNPM_UNSUPPORTED_ENGINEpnpm9.x9依赖安装异常Maven3.63.6依赖下载超时项目拉取与依赖安装JeecgBoot 采用前后端分离架构需要拉取两个仓库# 后端 git clone https://github.com/jeecgboot/jeecg-boot.git # 前端 git clone https://github.com/jeecgboot/jeecgboot-vue3.gitMaven 依赖下载是第二个容易卡住的地方。默认中央仓库在国内访问不稳定经常遇到Connection timed out。建议在~/.m2/settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror前端依赖同样可能遇到网络问题。pnpm 换源方案# 设置淘宝镜像 pnpm config set registry https://registry.npmmirror.com # 或者在项目根目录创建 .npmrc registryhttps://registry.npmmirror.com数据库配置与初始化进入jeecg-boot/jeecg-boot/src/main/resources目录找到application-dev.yml修改数据库连接信息spring: datasource: url: jdbc:mysql://localhost:3306/jeecg-boot?characterEncodingUTF-8useUnicodetrueuseSSLfalsetinyInt1isBitfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai username: root password: your_passwordMySQL 初始化脚本的执行顺序很关键不要直接全选运行。正确的顺序是jeecgboot_mysql5.7_基础库.sql— 创建数据库和基础表结构jeecgboot_mysql5.7_ quartz.sql— 定时任务相关表jeecgboot_mysql5.7_ 其他模块.sql— 按业务模块补充我最初没注意顺序结果 quartz 表报错外键约束失败排查了半小时才发现是基础库没先执行。前后端启动与验证后端启动用 IDEA 打开jeecg-boot项目务必先安装 Lombok 插件否则代码里全是红的编译也过不了。这是 JeecgBoot 重度依赖的工具用来简化 Getter/Setter 和日志等样板代码。找到JeecgApplication.java直接运行main方法即可。启动成功后验证这几个地址后端服务http://localhost:8080Swagger 接口文档http://localhost:8080/swagger-ui.html如果 8080 端口被占用可以用以下命令快速排查# Windows netstat -ano | findstr :8080 # Mac/Linux lsof -i :8080查到 PID 后Windows 用taskkill /PID pid /FMac/Linux 用kill -9 pid释放端口。或者直接在application-dev.yml里改server.port。前端启动cd jeecgboot-vue3 pnpm install pnpm run dev默认启动在http://localhost:3100热更新很及时改完代码浏览器会自动刷新。如果看到登录页说明前后端联调成功默认账号admin/123456。一个容易忽略的细节有些开发者习惯用 VS Code 开发前端但 JeecgBoot 官方更推荐WebStorm或VS Code Volar 插件。TypeScript 的类型提示在 WebStorm 里体验更好尤其是处理script setup语法和复杂的泛型推导时。另外如果你本地同时跑了多个 Java 项目注意 IDEA 右下角的事件日志有时候端口冲突不会报错但服务起不来这时候看日志比反复重启更有效。环境搭好后JeecgBoot 的代码生成器、Online 表单这些低代码能力就可以开始体验了。不过那是另一篇的话题先把基础打扎实。 
长河君 · 2026/8/28 22:55:00 · 阅读 1.2k JeecgBoot环境搭建踩坑实录，从零跑通前后端
第一次接触 JeecgBoot 时我花了将近半天时间才把整个环境跑通中间踩的坑大多集中在版本匹配和网络配置上。如果你也正准备从零开始这篇记录应该能帮你省下不少时间。环境准备版本匹配是第一位JeecgBoot 对运行环境有明确要求JDK 推荐 17兼容 8 和 21但 17 是目前最稳定的甜点版本。Node.js 则必须 20 以上因为前端用到了 Vite 6而 Vite 6 依赖 Node 18/20。我第一次图省事用了 Node 16结果pnpm install直接报错提示ERR_PNPM_UNSUPPORTED_ENGINE折腾一圈才发现是版本问题。这里有个容易忽略的点pnpm 版本要 9 以上。可以用pnpm -v快速检查不满足的话用npm install -g pnpmlatest升级即可。组件推荐版本最低要求常见报错JDK178编译失败、Lombok 注解不生效Node.js20.15.020ERR_PNPM_UNSUPPORTED_ENGINEpnpm9.x9依赖安装异常Maven3.63.6依赖下载超时项目拉取与依赖安装JeecgBoot 采用前后端分离架构需要拉取两个仓库# 后端 git clone https://github.com/jeecgboot/jeecg-boot.git # 前端 git clone https://github.com/jeecgboot/jeecgboot-vue3.gitMaven 依赖下载是第二个容易卡住的地方。默认中央仓库在国内访问不稳定经常遇到Connection timed out。建议在~/.m2/settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOf*/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror前端依赖同样可能遇到网络问题。pnpm 换源方案# 设置淘宝镜像 pnpm config set registry https://registry.npmmirror.com # 或者在项目根目录创建 .npmrc registryhttps://registry.npmmirror.com数据库配置与初始化进入jeecg-boot/jeecg-boot/src/main/resources目录找到application-dev.yml修改数据库连接信息spring: datasource: url: jdbc:mysql://localhost:3306/jeecg-boot?characterEncodingUTF-8useUnicodetrueuseSSLfalsetinyInt1isBitfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai username: root password: your_passwordMySQL 初始化脚本的执行顺序很关键不要直接全选运行。正确的顺序是jeecgboot_mysql5.7_基础库.sql— 创建数据库和基础表结构jeecgboot_mysql5.7_ quartz.sql— 定时任务相关表jeecgboot_mysql5.7_ 其他模块.sql— 按业务模块补充我最初没注意顺序结果 quartz 表报错外键约束失败排查了半小时才发现是基础库没先执行。前后端启动与验证后端启动用 IDEA 打开jeecg-boot项目务必先安装 Lombok 插件否则代码里全是红的编译也过不了。这是 JeecgBoot 重度依赖的工具用来简化 Getter/Setter 和日志等样板代码。找到JeecgApplication.java直接运行main方法即可。启动成功后验证这几个地址后端服务http://localhost:8080Swagger 接口文档http://localhost:8080/swagger-ui.html如果 8080 端口被占用可以用以下命令快速排查# Windows netstat -ano | findstr :8080 # Mac/Linux lsof -i :8080查到 PID 后Windows 用taskkill /PID pid /FMac/Linux 用kill -9 pid释放端口。或者直接在application-dev.yml里改server.port。前端启动cd jeecgboot-vue3 pnpm install pnpm run dev默认启动在http://localhost:3100热更新很及时改完代码浏览器会自动刷新。如果看到登录页说明前后端联调成功默认账号admin/123456。一个容易忽略的细节有些开发者习惯用 VS Code 开发前端但 JeecgBoot 官方更推荐WebStorm或VS Code Volar 插件。TypeScript 的类型提示在 WebStorm 里体验更好尤其是处理script setup语法和复杂的泛型推导时。另外如果你本地同时跑了多个 Java 项目注意 IDEA 右下角的事件日志有时候端口冲突不会报错但服务起不来这时候看日志比反复重启更有效。环境搭好后JeecgBoot 的代码生成器、Online 表单这些低代码能力就可以开始体验了。不过那是另一篇的话题先把基础打扎实。