1. Ruoyi框架实战入门指南Ruoyi若依作为国内流行的Java快速开发框架已经成为许多中小型项目的首选技术方案。我最近在一个电商后台管理系统中深度使用了Ruoyi框架从最初的框架选型到最终的项目部署积累了不少实战经验。这套框架特别适合需要快速搭建企业级应用但资源有限的开发团队它内置的代码生成器和权限管理系统能节省至少40%的开发时间。提示Ruoyi目前有两个主要版本 - 基于Spring Boot的单体应用版本和基于Spring Cloud的微服务版本新手建议从单体版本开始学习。2. Ruoyi核心架构解析2.1 技术栈组成Ruoyi采用了经典的分层架构设计前端Vue.js Element UI后端Spring Boot MyBatis Shiro数据库MySQL默认/Oracle可选缓存Redis消息队列内置RabbitMQ支持这套技术组合的亮点在于前端采用VueElementUI组件丰富且文档完善后端使用主流的Spring Boot体系社区支持强大权限控制集成Apache Shiro配置灵活2.2 核心模块功能Ruoyi框架内置了企业应用常见的核心功能模块用户管理完整的RBAC权限控制系统菜单管理支持多级菜单和按钮级权限角色管理细粒度的权限分配部门管理组织架构树形展示岗位管理职位与权限关联字典管理统一管理系统枚举值参数管理系统配置集中管理操作日志记录用户关键操作登录日志追踪系统访问情况3. 开发环境搭建实战3.1 基础环境准备在开始Ruoyi项目前需要准备以下环境JDK 1.8推荐JDK11Maven 3.5MySQL 5.7Redis 5.0Node.js 12前端开发需要注意Ruoyi对JDK版本较敏感使用JDK17等高版本可能出现兼容性问题建议使用JDK8或JDK11。3.2 项目初始化步骤从GitHub克隆项目git clone https://github.com/yangzongzhuan/RuoYi.git导入数据库脚本mysql -u root -p ry_2023xxxx.sql修改配置文件# application.yml spring: datasource: url: jdbc:mysql://localhost:3306/ry?useSSLfalse username: root password: yourpassword启动后端服务mvn spring-boot:run启动前端服务cd ruoyi-ui npm install npm run dev4. 代码生成器深度使用4.1 单表CRUD生成Ruoyi的代码生成器是其最大亮点之一。以生成一个商品管理模块为例在数据库中创建商品表CREATE TABLE product ( id bigint(20) NOT NULL AUTO_INCREMENT, name varchar(100) NOT NULL COMMENT 商品名称, price decimal(10,2) NOT NULL COMMENT 商品价格, stock int(11) NOT NULL COMMENT 库存数量, status char(1) DEFAULT 0 COMMENT 状态0正常 1停用, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8 COMMENT商品表;在系统管理 → 代码生成中导入该表配置生成选项生成包名com.ruoyi.product模块名product业务名product作者yourname点击生成代码按钮下载zip包将生成的代码分别放置到对应位置main/java → 后端Java代码main/resources → XML映射文件vue → 前端Vue文件4.2 生成代码结构解析生成的代码包含完整的CRUD功能Controller处理HTTP请求Service业务逻辑层Mapper数据库操作接口Entity数据实体类Vue组件列表页和表单页API定义前端接口调用经验生成代码后建议先检查实体类字段类型是否与数据库匹配特别是日期时间类型。5. 权限系统定制开发5.1 权限控制原理Ruoyi使用Apache Shiro实现权限控制核心流程用户登录 → 获取角色和权限信息访问资源 → 触发权限检查Shiro Realm → 验证权限通过 → 继续访问拒绝 → 返回403错误5.2 自定义权限注解除了内置的RequiresPermissions注解我们可以扩展更灵活的权限控制Target({ElementType.TYPE, ElementType.METHOD}) Retention(RetentionPolicy.RUNTIME) public interface CustomPermission { String value(); Logical logical() default Logical.AND; }然后在AOP中处理这个注解Aspect Component public class CustomPermissionAspect { Before(annotation(customPermission)) public void before(CustomPermission customPermission) { // 自定义权限校验逻辑 } }6. 常见问题解决方案6.1 连接拒绝问题排查当出现Ruoyi拒绝连接请求错误时按以下步骤排查检查服务是否正常启动查看控制台日志访问/actuator/health端点检查网络连接telnet 127.0.0.1 8080检查防火墙设置检查Nginx配置如果使用反向代理location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }检查跨域配置Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(*) .allowedHeaders(*); } }6.2 性能优化建议启用Redis缓存spring: cache: type: redis redis: host: localhost port: 6379配置MyBatis二级缓存cache evictionLRU flushInterval60000 size512 readOnlytrue/启用Gzip压缩server: compression: enabled: true mime-types: text/html,text/xml,text/plain,application/json7. 项目部署实战7.1 后端部署打包项目mvn clean package -DskipTests上传jar包到服务器启动服务nohup java -jar ruoyi.jar --server.port8080 ruoyi.log 21 7.2 前端部署构建生产版本npm run build:prod配置Nginxserver { listen 80; server_name yourdomain.com; location / { root /path/to/dist; index index.html; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://127.0.0.1:8080/; } }8. 扩展功能开发8.1 集成第三方登录以微信登录为例添加依赖dependency groupIdcom.github.scribejava/groupId artifactIdscribejava-apis/artifactId version8.3.1/version /dependency实现登录逻辑Service public class WechatLoginService { public String getAuthorizationUrl() { // 构建微信OAuth2授权URL } public String getAccessToken(String code) { // 获取access token } public WechatUserInfo getUserInfo(String accessToken) { // 获取用户信息 } }8.2 定时任务集成Ruoyi内置了Quartz定时任务支持创建任务类public class ProductSyncTask { public void syncProducts() { // 同步商品数据逻辑 } }在管理界面配置定时任务任务名称商品同步调用目标productSyncTask.syncProductsCron表达式0 0 2 * * ? 每天凌晨2点执行9. 项目实战经验分享在实际项目中使用Ruoyi框架时我总结了以下几点经验代码生成器生成的代码是基础版本需要根据业务需求进行二次开发权限系统虽然完善但复杂的业务权限需要自定义实现前端页面风格统一但Element UI组件需要深入学习才能灵活使用系统监控功能很实用可以及时发现性能瓶颈多环境配置切换方便适合敏捷开发流程一个特别实用的技巧是在开发阶段可以开启Swagger文档支持方便接口调试Configuration EnableSwagger2 public class SwaggerConfig { Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage(com.ruoyi.web.controller)) .paths(PathSelectors.any()) .build(); } }
)
