1. 若依框架入门指南若依RuoYi作为国内流行的开源后台管理系统框架凭借其完善的权限体系和丰富的功能组件已成为众多开发者快速构建企业级应用的首选。我使用这套框架已有三年时间从最初的2.x版本到现在的4.x系列见证了它的功能迭代与生态发展。提示若依基于Spring BootMyBatis技术栈采用经典的前后端分离架构特别适合需要快速开发后台管理系统的场景。1.1 环境准备要点开发若依项目需要配置以下基础环境JDK 1.8推荐Amazon Corretto 11MySQL 5.7注意字符集需设置为utf8mb4Redis 5.0Maven 3.6Node.js 14前端开发需要安装MySQL时有个细节容易忽略需要手动创建数据库并执行初始化SQL。我建议先创建名为ry的数据库然后执行框架提供的sql/ry_2021xxxx.sql和quartz.sql两个脚本。曾经有新手直接启动项目导致表结构缺失排查了半天才发现问题所在。1.2 项目结构解析解压后的若依项目包含以下核心模块ruoyi-admin // 后台服务模块 ruoyi-common // 通用工具类 ruoyi-framework // 框架核心 ruoyi-system // 系统模块 ruoyi-quartz // 定时任务 ruoyi-generator // 代码生成 ruoyi-ui // 前端Vue项目后端开发主要关注ruoyi-admin和ruoyi-system模块前者是启动入口后者包含用户、角色、菜单等核心业务代码。前端开发者则需要重点研究ruoyi-ui目录下的Vue组件。2. 核心功能实战2.1 权限系统配置若依的RBAC权限模型是其最大亮点。实际配置时建议按以下流程操作创建角色系统管理 → 角色管理 → 新增菜单分配为角色勾选可访问的菜单用户关联将用户与对应角色绑定我遇到过一个典型问题新增菜单后角色依然无法访问。后来发现需要同时配置两个地方sys_menu表设置正确的perms字段在RequiresPermissions注解中声明权限标识2.2 代码生成器使用内置的代码生成器能节省大量CRUD开发时间。操作步骤配置数据源ruoyi-generator模块的application.yml修改模板resources/vm目录下的VM文件生成代码访问/tool/gen页面选择表有个实用技巧生成前端代码前先修改vm/vue/index.vue.vm模板可以预设好表格列宽、排序规则等配置。我通常会添加以下优化// 在created钩子中添加默认排序 created() { this.queryParams.orderByColumn create_time this.queryParams.isAsc desc }3. 深度定制开发3.1 自定义starter开发企业级项目通常需要封装自己的starter。以短信服务为例创建ruoyi-sms模块添加自动配置类Configuration ConditionalOnProperty(prefix sms, name enabled, havingValue true) public class SmsAutoConfiguration { Bean public AliyunSmsService smsService() { return new AliyunSmsService(); } }在resources/META-INF下添加spring.factories3.2 多数据源配置若依默认支持多数据源但需要特别注意事务管理。建议采用以下方案主数据源使用Primary注解其他数据源添加DS(slave)注解避免跨数据源事务我曾踩过一个坑在同一个Service方法中同时操作主从库导致事务失效。后来通过拆分Service层解决了这个问题。4. 性能优化实践4.1 缓存策略优化默认的Redis缓存可以进一步优化spring: cache: type: redis redis: time-to-live: 1800000 # 30分钟 key-prefix: ry:cache: use-key-prefix: true对于热点数据建议使用二级缓存策略本地Caffeine缓存短期数据Redis缓存中长期数据数据库持久化存储4.2 线程池配置修改ThreadPoolConfig类中的参数Bean public ThreadPoolTaskExecutor threadPoolTaskExecutor() { ThreadPoolTaskExecutor executor new ThreadPoolTaskExecutor(); executor.setCorePoolSize(Runtime.getRuntime().availableProcessors() * 2); executor.setMaxPoolSize(50); executor.setQueueCapacity(1000); executor.setThreadNamePrefix(ry-task-); return executor; }5. 常见问题排查5.1 启动类冲突若出现Failed to configure a DataSource错误通常是因为未正确配置数据库连接多模块间存在依赖冲突包扫描路径重叠解决方案SpringBootApplication(exclude { DataSourceAutoConfiguration.class })5.2 权限校验失效当接口权限突然失效时检查用户角色是否被修改菜单权限标识是否变更缓存是否及时更新可以通过清除Redis缓存解决redis-cli keys ry:cache:* | xargs redis-cli del6. 项目部署方案6.1 后端部署推荐使用Docker Compose部署version: 3 services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: root volumes: - ./mysql:/var/lib/mysql redis: image: redis:5.0 ports: - 6379:6379 ruoyi: build: . ports: - 8080:8080 depends_on: - mysql - redis6.2 前端部署Nginx配置示例server { listen 80; server_name yourdomain.com; location / { root /usr/share/nginx/html/ruoyi-ui; index index.html; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://backend:8080/; } }若依框架的学习曲线其实很平缓但想要真正掌握其设计精髓建议从权限体系入手逐步深入到定时任务、工作流等高级模块。我在实际项目中最大的体会是与其盲目修改源码不如先充分理解现有机制再通过扩展点进行定制开发。
若依框架开发实战：从入门到企业级应用
1. 若依框架入门指南若依RuoYi作为国内流行的开源后台管理系统框架凭借其完善的权限体系和丰富的功能组件已成为众多开发者快速构建企业级应用的首选。我使用这套框架已有三年时间从最初的2.x版本到现在的4.x系列见证了它的功能迭代与生态发展。提示若依基于Spring BootMyBatis技术栈采用经典的前后端分离架构特别适合需要快速开发后台管理系统的场景。1.1 环境准备要点开发若依项目需要配置以下基础环境JDK 1.8推荐Amazon Corretto 11MySQL 5.7注意字符集需设置为utf8mb4Redis 5.0Maven 3.6Node.js 14前端开发需要安装MySQL时有个细节容易忽略需要手动创建数据库并执行初始化SQL。我建议先创建名为ry的数据库然后执行框架提供的sql/ry_2021xxxx.sql和quartz.sql两个脚本。曾经有新手直接启动项目导致表结构缺失排查了半天才发现问题所在。1.2 项目结构解析解压后的若依项目包含以下核心模块ruoyi-admin // 后台服务模块 ruoyi-common // 通用工具类 ruoyi-framework // 框架核心 ruoyi-system // 系统模块 ruoyi-quartz // 定时任务 ruoyi-generator // 代码生成 ruoyi-ui // 前端Vue项目后端开发主要关注ruoyi-admin和ruoyi-system模块前者是启动入口后者包含用户、角色、菜单等核心业务代码。前端开发者则需要重点研究ruoyi-ui目录下的Vue组件。2. 核心功能实战2.1 权限系统配置若依的RBAC权限模型是其最大亮点。实际配置时建议按以下流程操作创建角色系统管理 → 角色管理 → 新增菜单分配为角色勾选可访问的菜单用户关联将用户与对应角色绑定我遇到过一个典型问题新增菜单后角色依然无法访问。后来发现需要同时配置两个地方sys_menu表设置正确的perms字段在RequiresPermissions注解中声明权限标识2.2 代码生成器使用内置的代码生成器能节省大量CRUD开发时间。操作步骤配置数据源ruoyi-generator模块的application.yml修改模板resources/vm目录下的VM文件生成代码访问/tool/gen页面选择表有个实用技巧生成前端代码前先修改vm/vue/index.vue.vm模板可以预设好表格列宽、排序规则等配置。我通常会添加以下优化// 在created钩子中添加默认排序 created() { this.queryParams.orderByColumn create_time this.queryParams.isAsc desc }3. 深度定制开发3.1 自定义starter开发企业级项目通常需要封装自己的starter。以短信服务为例创建ruoyi-sms模块添加自动配置类Configuration ConditionalOnProperty(prefix sms, name enabled, havingValue true) public class SmsAutoConfiguration { Bean public AliyunSmsService smsService() { return new AliyunSmsService(); } }在resources/META-INF下添加spring.factories3.2 多数据源配置若依默认支持多数据源但需要特别注意事务管理。建议采用以下方案主数据源使用Primary注解其他数据源添加DS(slave)注解避免跨数据源事务我曾踩过一个坑在同一个Service方法中同时操作主从库导致事务失效。后来通过拆分Service层解决了这个问题。4. 性能优化实践4.1 缓存策略优化默认的Redis缓存可以进一步优化spring: cache: type: redis redis: time-to-live: 1800000 # 30分钟 key-prefix: ry:cache: use-key-prefix: true对于热点数据建议使用二级缓存策略本地Caffeine缓存短期数据Redis缓存中长期数据数据库持久化存储4.2 线程池配置修改ThreadPoolConfig类中的参数Bean public ThreadPoolTaskExecutor threadPoolTaskExecutor() { ThreadPoolTaskExecutor executor new ThreadPoolTaskExecutor(); executor.setCorePoolSize(Runtime.getRuntime().availableProcessors() * 2); executor.setMaxPoolSize(50); executor.setQueueCapacity(1000); executor.setThreadNamePrefix(ry-task-); return executor; }5. 常见问题排查5.1 启动类冲突若出现Failed to configure a DataSource错误通常是因为未正确配置数据库连接多模块间存在依赖冲突包扫描路径重叠解决方案SpringBootApplication(exclude { DataSourceAutoConfiguration.class })5.2 权限校验失效当接口权限突然失效时检查用户角色是否被修改菜单权限标识是否变更缓存是否及时更新可以通过清除Redis缓存解决redis-cli keys ry:cache:* | xargs redis-cli del6. 项目部署方案6.1 后端部署推荐使用Docker Compose部署version: 3 services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: root volumes: - ./mysql:/var/lib/mysql redis: image: redis:5.0 ports: - 6379:6379 ruoyi: build: . ports: - 8080:8080 depends_on: - mysql - redis6.2 前端部署Nginx配置示例server { listen 80; server_name yourdomain.com; location / { root /usr/share/nginx/html/ruoyi-ui; index index.html; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://backend:8080/; } }若依框架的学习曲线其实很平缓但想要真正掌握其设计精髓建议从权限体系入手逐步深入到定时任务、工作流等高级模块。我在实际项目中最大的体会是与其盲目修改源码不如先充分理解现有机制再通过扩展点进行定制开发。
