若依(RuoYi-Vue)代码生成器实战：从零掌握单表CURD开发

前言若依框架是国内最流行的Spring Boot后台管理系统之一其强大的代码生成器可以让我们告别繁琐的增删改查开发只需几步操作就能生成完整的业务代码。本文将完整记录使用若伊代码生成器完成单表CURD的全流程并分享实际开发中遇到的各种坑及解决方案。一、准备工作在开始之前请确保以下环境都已就绪✅ Ruoyi-Vue 项目能正常启动前端、后端、数据库都已连通✅ 准备好数据库管理工具如 Navicat✅ 准备好一个用于测试的数据库表本文以学生表my_student为例二、核心步骤详解第一步创建数据库表并添加数据打开 Navicat 等数据库管理工具新建一张表添加所需字段如学生姓名、学号、年龄等并插入几条测试数据。 重要提示务必给表和每个字段添加清晰的中文注释这将直接影响生成页面的字段显示。第二步在若依中导入表1.启动 Ruoyi-Vue 项目并登录系统2.找到「系统工具」→「代码生成」功能3.点击「导入」勾选刚才创建的my_student表确认导入第三步填写生成配置信息找到导入的表记录点击「编辑」按钮进行配置需要填写三部分配置项说明示例基本信息表名、作者等保留默认即可作者改为自己名字字段信息配置字段显示方式、是否必填、是否可查询等通常保留默认生成包路径后端Java包名com.ruoyi.student生成模块名影响后端代码存放目录student生成业务名构成请求路径建议与模块名不同studentInfo生成父菜单名新功能挂载位置系统工具第四步下载生成的代码文件确认配置无误后点击「生成」按钮系统会下载一个压缩包包含main/- 后端代码vue/- 前端代码.sql- 菜单配置文件第五步拷贝代码并导入SQL5.1 执行SQL文件必须先执行用数据库工具打开压缩包里的.sql文件并执行这会将新功能入口写入系统菜单表。5.2 拷贝后端代码文件类型压缩包路径应放置位置Java核心代码main/java/...ruoyi-admin/src/main/java/com/ruoyi/Mapper XMLmain/resources/mapper/...ruoyi-admin/src/main/resources/mapper/Controllermain/java/...ruoyi-admin/src/main/java/com/ruoyi/web/controller/⚠️特别注意Controller 必须放在ruoyi-admin模块的 controller 包下5.3 拷贝前端代码文件类型压缩包路径应放置位置接口文件vue/api/...前端src/api/目录页面文件vue/views/...前端src/views/system/student/目录第六步重新运行并测试重启后端服务前端一般会自动热更新刷新页面即可看到新功能入口。测试增删改查功能是否正常。三、实战问题汇总与解决方案问题一Controller 重复冲突报错信息Annotation-specified bean name myStudentController conflicts with existing原因Controller 文件被放到了两个不同的包路径。解决删除com.ruoyi.student.controller下的重复文件只保留com.ruoyi.web.controller.student下的 Controller。问题二页面显示${{comment}}占位符原因数据库表没有添加注释导致代码生成器无法获取字段中文描述。解决1.在 Navicat 中给表和字段添加中文注释2.在若依中删除原导入记录重新导入表3.重新生成代码并覆盖问题三菜单重复出现原因多次生成导致 SQL 被重复执行菜单数据重复插入。解决1.进入「系统管理」→「菜单管理」2.展开重复菜单先删除子项新增、修改、删除等按钮3.再删除父级菜单只保留一个问题四页面打不开提示Cannot find module报错信息Error: Cannot find module ./system/student/index原因前端文件放置路径与系统记录的路径不一致。解决将 Vue 页面文件夹移动到src/views/system/student/目录下。问题五接口 404报错信息/dev-api/system/student/list:1 404 (Not Found)原因Controller 的请求映射路径与前端请求地址不匹配。解决修改 Controller 的RequestMapping注解为/system/student与前端请求路径保持一致。四、总结若依代码生成器确实能极大提升开发效率但在使用过程中需要注意1.数据库注释- 一定要写否则页面显示占位符2.文件位置- Controller 必须放在 ruoyi-admin 模块的 controller 包下3.菜单管理- 每次重新生成前先删除旧记录避免菜单重复4.路径匹配- 前后端路径要保持一致特别是模块名和业务名遇到问题不要慌仔细看报错信息大部分问题都能快速定位解决。祝你开发顺利