手把手教你部署RuoYi若依（非分离版）开发环境

1. 环境准备从零搭建RuoYi开发环境第一次接触RuoYi若依框架时我也被它开箱即用的特性吸引。这个基于Spring Boot的快速开发平台确实能省去很多重复造轮子的时间。不过在实际部署过程中我发现新手常会在环境配置环节卡壳。下面我就用最直白的语言带你走通整个流程。硬件要求其实很亲民普通开发机就能跑起来。关键是软件环境要配齐三件套JDK 1.8推荐OpenJDK 11MySQL 5.7注意要配置好大小写敏感Maven 3.6国内用户记得配镜像源我建议先用命令行验证基础环境java -version mysql --version mvn -v如果这三个命令都能正确输出版本号说明基础环境没问题。遇到过有同事在Windows系统部署时因为PATH环境变量没配好导致命令找不到这种情况需要检查系统环境变量配置。2. 源码获取与项目导入2.1 源码下载避坑指南官方源码仓库在Giteehttps://gitee.com/y_project/RuoYi下载时注意选择非分离版。有个常见误区是下载成前后端分离版本导致后续配置对不上。我习惯用git clone方式获取代码git clone https://gitee.com/y_project/RuoYi.git这样后续更新更方便。下载完成后建议检查下目录结构标准的非分离版应该包含这些关键目录ruoyi-admin核心模块ruoyi-common通用工具ruoyi-framework框架核心ruoyi-generator代码生成ruoyi-quartz定时任务2.2 IDEA导入实战技巧用IntelliJ IDEA导入时选择File - New - Project from Existing Sources然后选择项目根目录下的pom.xml。这里有个小技巧首次导入时建议勾选Search for projects recursively选项确保所有子模块都能被识别。导入过程中最耗时的就是Maven依赖下载。遇到过有团队在内网环境部署时因为没配镜像源导致依赖下载失败。这时候可以修改Maven的settings.xmlmirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror3. 数据库配置详解3.1 数据库初始化创建数据库时要注意字符集设置CREATE DATABASE ry DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;执行官方提供的SQL脚本时建议按这个顺序ry_xxxxxx.sql主业务数据quartz.sql定时任务表后续的业务模块SQL如需要遇到过有开发者反馈表创建失败八成是MySQL运行在严格模式导致的。可以检查下SQL模式SELECT GLOBAL.sql_mode;如果包含STRICT_TRANS_TABLES建议临时修改为宽松模式。3.2 连接配置调优修改ruoyi-admin模块下的application-druid.yml时这几个参数需要特别关注spring: datasource: druid: # 初始连接数 initialSize: 5 # 最小空闲连接 minIdle: 10 # 最大活跃连接 maxActive: 50 # 获取连接超时时间毫秒 maxWait: 60000生产环境建议根据实际负载调整这些参数。遇到过性能问题最后发现是maxActive设置过小导致连接池耗尽。4. 项目启动与验证4.1 启动排错指南运行RuoYiApplication主类时常见问题有端口冲突默认8080被占修改application.yml中的server.port数据库连接失败检查用户名密码验证数据库服务是否启动Redis连接异常如果启用了redis配置注释掉redis相关配置先跳过启动成功后访问http://localhost:8080应该能看到登录页。如果遇到静态资源404可能是Thymeleaf模板解析问题检查下控制台是否有模板引擎报错。4.2 初始账户安全系统默认账号admin/admin123一定要记得修改我遇到过测试服务器被黑的情况就是因为用了默认密码。建议首次登录后立即修改管理员密码创建新用户并分配权限停用或删除默认测试账户5. 代码生成实战5.1 模块创建规范新建业务模块时我推荐这样的结构exam-paper ├── src/main/java │ └── com.ruoyi │ └── exam │ ├── config配置类 │ ├── controller控制器 │ ├── domain实体 │ ├── mapper持久层 │ └── service服务层 └── src/main/resources └── mapperMyBatis映射文件这种结构清晰且符合RuoYi的约定。在父pom中添加依赖时注意版本号要使用${ruoyi.version}占位符保持版本统一。5.2 代码生成技巧使用系统自带的代码生成器时有几个实用技巧生成前先预览检查字段映射是否正确勾选启用树结构可以快速生成树形菜单生成后记得执行菜单SQL才能看到新功能对于复杂业务可以先生成基础代码再手动扩展遇到过生成代码后页面报错的情况通常是这两类问题字段类型映射错误如数据库datetime映射成LocalDateTime表关联关系没在生成时正确配置6. 开发环境优化建议6.1 热部署配置提高开发效率的关键是配置好热部署。在IDEA中开启Build - Compiler - Build project automatically注册表添加compiler.automake.allow.when.app.running添加spring-boot-devtools依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId scoperuntime/scope optionaltrue/optional /dependency6.2 日志调试技巧建议在开发环境调整日志级别logging: level: root: info com.ruoyi: debug org.springframework.web: warn这样既能查看业务日志又不会淹没在框架的调试信息中。对于复杂问题可以临时开启SQL日志mybatis: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl7. 常见问题解决方案7.1 启动时报ClassNotFound这通常是依赖问题导致的可以尝试执行mvn clean install检查子模块依赖是否正确定义查看IDEA的Project Structure - Modules7.2 页面样式错乱如果发现页面样式异常可能是浏览器缓存问题强制刷新或清缓存静态资源未正确加载检查Network面板Thymeleaf模板解析错误查看控制台日志7.3 事务不生效问题遇到事务不回滚的情况检查是否在启动类加了EnableTransactionManagement异常类型是否在Transactional中声明方法是否为publicSpring事务基于代理实际项目中还遇到过Shiro权限缓存问题可以通过在开发环境关闭缓存来调试shiro.cache.enabledfalse经过这些步骤你应该已经能顺畅地开发和调试RuoYi项目了。这套框架最棒的地方在于当你熟悉基础结构后可以快速实现业务需求。我在电商项目中用RuoYi做后台管理两周就完成了商品、订单、会员三大核心模块的开发。