JEECG-BOOT+Vue3全栈开发环境搭建保姆级教程（含Redis配置避坑指南）

JEECG-BOOTVue3全栈开发环境搭建实战指南最近在帮团队搭建JEECG-BOOTVue3的全栈开发环境时发现网上很多教程都忽略了实际配置中的关键细节。特别是当JDK版本、Maven镜像、Redis连接这些基础组件出现问题时新手往往要花费大量时间排查。本文将基于实战经验带你完整走通从零开始的环境搭建流程重点解决那些官方文档没提到的坑点。1. 开发环境基础配置1.1 JDK版本选择与安装JEECG-BOOT官方推荐使用JDK8但在实际测试中JDK11也能良好运行。关键区别在于特性JDK8JDK11兼容性官方推荐最稳定需要修改部分POM配置性能一般启动速度提升约15%长期支持已结束支持到2026年安装后需要检查环境变量配置是否正确# 检查Java版本 java -version # 检查JAVA_HOME路径 echo %JAVA_HOME%注意如果同时安装多个JDK版本建议使用JEnv或手动修改JAVA_HOME变量来切换避免环境混乱。1.2 Maven加速配置国内开发者必须修改Maven镜像源否则依赖下载会非常缓慢。修改settings.xml文件mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror常见问题排查依赖下载失败删除本地仓库(~/.m2/repository)后重试版本冲突使用mvn dependency:tree查看依赖树构建缓慢添加-T 1C参数启用多线程编译1.3 数据库准备MySQL安装后需要特别注意初始化密码安全策略创建专用数据库用户调整默认字符集为utf8mb4推荐使用Docker快速部署docker run --name mysql-jeecg -e MYSQL_ROOT_PASSWORDyourpassword -p 3306:3306 -d mysql:5.7 --character-set-serverutf8mb4 --collation-serverutf8mb4_unicode_ci2. 后端项目配置详解2.1 源码导入与依赖安装使用IDEA导入项目时关键步骤包括选择pom.xml作为项目描述文件启用自动导入依赖功能安装Lombok插件必须重启生效常见问题解决方案编译报错检查JDK版本是否匹配注解失效确认Lombok插件已启用测试失败可能是数据库连接问题2.2 数据库初始化技巧执行SQL脚本时容易遇到的坑注释掉脚本中强制使用jeecg-boot库的语句确保数据库字符集为utf8mb4如果使用MySQL8.0需要调整密码加密方式-- 修改用户密码加密方式MySQL8.0需要 ALTER USER jeecg% IDENTIFIED WITH mysql_native_password BY password;2.3 Redis连接配置避坑application-dev.yml中Redis配置常见问题redis: database: 0 host: 127.0.0.1 port: 6379 password: timeout: 3000 # 超时时间建议设为3秒连接失败排查步骤检查Redis服务是否启动确认防火墙放行了6379端口测试telnet连接telnet 127.0.0.1 6379查看Redis日志tail -f /var/log/redis/redis-server.log提示Windows下Redis默认没有设置密码但Linux安装后可能启用了保护模式3. 前端环境搭建实战3.1 Node.js与包管理器配置推荐使用nvm管理Node版本# 安装LTS版本 nvm install 16.14.2 # 设置默认版本 nvm use 16.14.2PNPM安装加速技巧# 设置淘宝镜像 pnpm config set registry https://registry.npmmirror.com # 解决权限问题Mac/Linux pnpm setup3.2 前端项目启动问题排查常见启动错误及解决方案依赖安装失败删除node_modules和lock文件后重试使用pnpm install --force强制重新安装端口冲突# 指定端口启动 pnpm dev --port 3001API请求跨域 修改vite.config.ts中的代理配置server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } }4. 前后端联调技巧4.1 接口调试最佳实践推荐使用Apifox或Postman进行接口测试导入JEECG-BOOT的Swagger文档配置环境变量管理不同环境的URL使用自动化测试功能验证关键流程4.2 验证码显示问题解决如果验证码无法显示检查以下配置后端application-dev.yml中的captcha配置项前端请求的API路径是否正确浏览器控制台是否有跨域错误4.3 性能优化建议开发环境调优参数后端JVM参数-Xms512m -Xmx1024m -XX:MaxPermSize256m前端构建参数pnpm build --modernRedis配置适当增加最大内存限制5. 常见问题速查手册5.1 错误代码速查表错误现象可能原因解决方案启动时报ClassNotFoundLombok未生效重启IDE检查注解处理器Redis连接超时防火墙限制/密码错误检查端口和认证配置前端页面空白路由配置错误/API失败查看浏览器控制台日志数据库表不存在SQL未执行/字符集不匹配重新导入SQL并检查字符集5.2 日志分析技巧关键日志位置后端日志logs/jeecg-boot.log前端错误浏览器开发者工具Console数据库日志MySQL的slow query log高效日志查询命令# 实时查看错误日志 tail -f logs/jeecg-boot.log | grep ERROR # 统计接口响应时间 cat logs/jeecg-boot.log | grep 耗时 | awk {print $NF}6. 进阶配置与优化6.1 Docker化部署准备创建Dockerfile.backendFROM openjdk:11-jre COPY target/jeecg-boot-module-system-3.4.4.jar /app.jar ENTRYPOINT [java,-jar,/app.jar]前端Docker构建优化FROM node:16 as builder WORKDIR /app COPY . . RUN pnpm install pnpm build FROM nginx:alpine COPY --frombuilder /app/dist /usr/share/nginx/html COPY nginx.conf /etc/nginx/conf.d/default.conf6.2 CI/CD集成建议GitLab CI示例配置stages: - build - deploy backend-build: stage: build script: - mvn clean package -DskipTests artifacts: paths: - target/*.jar frontend-build: stage: build script: - pnpm install - pnpm build artifacts: paths: - dist/6.3 监控与告警配置推荐监控指标JVM内存使用率通过PrometheusJMXAPI响应时间Spring Boot Actuator数据库连接池状态Druid监控告警规则示例当500错误率1%持续5分钟时触发当Redis内存使用80%时触发当接口平均响应时间1s时触发在实际项目部署中我发现最容易被忽视的是Redis的maxmemory配置特别是在Windows开发环境下默认配置可能导致内存无限增长。建议即使是在开发环境也设置合理的内存限制和淘汰策略避免服务突然崩溃。