若依(RuoYi-Vue)项目启动后，除了登录页你还能快速做这几件事

若依(RuoYi-Vue)项目启动后快速上手指南从登录页到实战开发的5个关键动作当你第一次成功启动若依前后端分离项目看到那个简洁的登录界面时可能既兴奋又迷茫——接下来我该做什么作为国内流行的Java快速开发框架若依(RuoYi)的强大之处在于它提供了一整套开箱即用的企业级解决方案。但要让这个框架真正为你所用需要快速掌握几个核心操作节点。1. 基础环境验证确保各组件正常运行登录页面能显示只说明前端服务启动成功但后端各组件是否正常工作需要进一步验证。若依内置的系统监控功能就是最好的检查工具。在登录页面使用默认管理员账号(admin/admin123)进入系统后立即导航至「系统监控」菜单下的「服务监控」子菜单。这里你会看到一个直观的仪表盘服务器信息CPU使用率、内存占用、磁盘空间 Redis状态连接数、内存使用情况 MySQL状态活跃连接数、查询缓存命中率如果Redis或MySQL显示连接失败通常是因为application.yml和application-druid.yml中的配置与实际环境不符。常见问题包括Redis未设置密码但配置文件中写了密码MySQL连接字符串中的时区设置缺失(建议添加?useSSLfalseserverTimezoneUTC)端口被占用导致服务未真正启动提示若依默认使用8080端口如果冲突可以在application.yml中修改server.port值记得同步调整前端vue.config.js中的代理设置。2. 权限体系初探理解路由与菜单的关联机制若依的权限控制是其核心功能之一理解这套机制对后续开发至关重要。通过以下几个步骤快速掌握菜单管理实操进入「系统管理」→「菜单管理」观察现有菜单的结构目录→菜单→按钮尝试添加一个测试菜单并分配权限前端路由对照 打开ruoyi-ui/src/router/index.js注意动态路由部分// 动态路由基于用户权限动态生成 export const dynamicRoutes [ { path: /system/user-auth, component: Layout, hidden: false, permissions: [system:user:edit], children: [...] } ]后端权限注解 查看任意Controller类中的方法注解PreAuthorize(ss.hasPermi(system:user:list)) GetMapping(/list) public TableDataInfo list(SysUser user) { //... }通过这三者的联动就能理解如何通过菜单配置控制页面访问通过权限字符串控制接口访问。3. 快速创建业务模块5分钟生成CRUD功能若依的代码生成器是其最高效的功能之一。以下是创建简单图书管理模块的完整流程准备数据库表CREATE TABLE biz_book ( id bigint NOT NULL AUTO_INCREMENT, title varchar(100) NOT NULL COMMENT 书名, author varchar(50) DEFAULT NULL COMMENT 作者, publish_date datetime DEFAULT NULL COMMENT 出版日期, create_by varchar(64) DEFAULT COMMENT 创建者, create_time datetime DEFAULT NULL COMMENT 创建时间, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT图书表;使用代码生成器进入「系统工具」→「代码生成」导入刚才创建的biz_book表生成代码并下载ZIP包前端集成 将生成的vue文件放入ruoyi-ui/src/views对应目录在router/index.js中添加路由{ path: book, component: () import(/views/modules/book/index), name: Book, meta: { title: 图书管理, icon: book } }刷新页面后一个完整的图书管理模块就已集成到系统中包含列表、新增、编辑、删除等全套功能。4. 深度定制修改系统默认行为了解如何修改框架默认行为可以避免后续开发中的困惑。以下是几个常见定制场景修改登录验证码配置# application.yml captcha: enabled: true # 改为false可关闭验证码 type: math # 可选 math/char调整JWT令牌有效期// RuoYiConfig.java Bean public JwtUtils jwtUtils() { JwtUtils jwtUtils new JwtUtils(); jwtUtils.setSecret(your-secret-key); jwtUtils.setExpireTime(30 * 60 * 1000L); // 30分钟 return jwtUtils; }自定义异常处理 创建全局异常处理器RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(BusinessException.class) public AjaxResult handleBusinessException(BusinessException e) { return AjaxResult.error(e.getMessage()); } }5. 性能优化准备监控与缓存配置在正式开发前建议先配置好性能监控和缓存策略开启Actuator端点management: endpoints: web: exposure: include: *访问/actuator/health可获取系统健康状态Redis缓存优化Configuration public class RedisConfig { Bean public RedisCacheManager cacheManager(RedisConnectionFactory factory) { RedisCacheConfiguration config RedisCacheConfiguration.defaultCacheConfig() .entryTtl(Duration.ofMinutes(30)) // 默认缓存30分钟 .disableCachingNullValues(); return RedisCacheManager.builder(factory) .cacheDefaults(config) .build(); } }SQL监控配置 在application-druid.yml中开启stat-view-servlet: enabled: true allow: 127.0.0.1 url-pattern: /druid/*访问http://localhost:8080/druid可查看SQL监控6. 开发环境效率工具链配置提升日常开发效率的几个实用配置热部署设置在pom.xml中添加devtools依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId scoperuntime/scope optionaltrue/optional /dependencyIDEA开启自动编译Settings → Build,Execution,Deployment → Compiler → 勾选Build project automaticallyAPI调试技巧 利用若依内置的Swagger支持添加依赖dependency groupIdio.springfox/groupId artifactIdspringfox-swagger2/artifactId version3.0.0/version /dependency访问http://localhost:8080/swagger-ui.html即可调试所有API前端调试建议 在vue.config.js中配置代理和source mapmodule.exports { devServer: { proxy: { /prod-api: { target: http://localhost:8080, changeOrigin: true, pathRewrite: { ^/prod-api: } } } }, configureWebpack: { devtool: source-map } }