若依(RuoYi)框架中普通用户角色登录后访问接口报 403 “当前操作没有权限”错误的完整解决方案

📌 问题现象

在基于 若依(RuoYi)框架 开发的系统中,我们为"普通用户"角色分配了某个功能模块的查询权限,但用户登录后访问对应页面时,接口请求显示200 OK,但是返回结果是

{"msg":"没有权限,请联系管理员授权","code":403}

前端提示:

✅ 正确解决步骤(亲测有效)

第一步:检查 Controller 权限注解

确保你的接口使用了正确的权限标识,例如:

@RestController

@RequestMapping("/process/transport")

public class TransportController {

@PreAuthorize("@ss.hasPermi('process:transport:list')")

@GetMapping("/list")

public TableDataInfo list(Transport transport) {

// ...

}

}

⚠️ 注意:权限字符串是 process:transport:list,不是 transport:list!

第二步:在「菜单管理」中配置按钮权限【管理员模式】

1、进入 系统管理 → 菜单管理

2、找到你的功能模块(如"运输管理"),类型为 菜单(M)

3、在其下新增 按钮(C),例如:

💡 权限字符必须与 Controller 中的 hasPermi() 参数完全一致!

第三步:给角色分配权限(最容易遗漏!)【管理员模式】

这是 90% 问题的根源!

1、进入 系统管理 → 角色管理

2、编辑目标角色(如"普通用户")

3、在 "菜单权限" 中:

展开"运输管理"

手动勾选"运输数据查询"按钮

确保"父子联动"已开启(否则需逐个勾选)

✅ 如果没勾选,即使按钮存在,系统也认为用户"没有这个权限"!

注意只要是调用到的接口,包括增删改查,都可以添加按钮,默认是隐藏的。

第四步:刷新权限缓存【可忽略此步骤】

若依默认将用户权限缓存在 Redis 中。修改数据库后必须刷新缓存!

方法一:重启服务(开发环境推荐)

停止并重启 Java 应用

pkill -f your-app.jar

nohup java -jar your-app.jar &

方法二:清空 Redis 缓存(生产环境可用)

redis-cli

> del sys:role:perms:*

> exit

❌ 不要重启 Redis 服务!只需删除特定 key 即可。

第五步:验证请求路径

使用浏览器开发者工具(F12 → Network),确认前端请求的是:

GET /process/transport/list

而不是:

GET /transport/list ❌ 路径错误,会 404 或绕过权限

🧩 常见误区总结【注意前后端权限标识一致!!!】

✅ 最佳实践建议

1、统一命名规范:

查询:module:resource:list
新增:module:resource:add
导出:module:resource:export

2、遵循最小权限原则:

普通用户只给 list 和 query
管理员再开放 add/edit/remove

3、开发时开启日志:

log.info("当前用户权限: {}", loginUser.getPermissions());

方便快速排查。

🎯 总结

若依 403 无权限 ≠ 没配权限,而是"配得不对"或"没生效"!

只要做到:

注解一致 + 菜单正确 + 角色分配 + 缓存刷新

就能彻底解决权限问题!

相关推荐
zzz_236813 小时前
【Spring】面试突击系列(三):Spring Web MVC 深度解析
前端·spring·面试
colofullove13 小时前
小说上传中心与异步处理进度展示设计
前端
Marst Code13 小时前
⚙️ 2026 年推荐技术方案
前端
qq_3660862213 小时前
测试接口传参数时,放在Header和Body中后台接收参数的区别
java·开发语言·前端
whatever who cares13 小时前
Vue3中vue文件和composables的分工
前端·javascript·vue.js
袋鼠云数栈UED团队13 小时前
基于 superpowers 实现复杂前端改造
前端
袋鼠云数栈前端13 小时前
基于 superpowers 实现复杂前端改造
前端·ai
sugar__salt13 小时前
LLM服务HTTP接口实战:前端HTTP请求全解与项目落地
前端·网络协议·http
薛先生_09914 小时前
vue-编程式跳转-基本跳转
前端·javascript·vue.js
微三云、小叶14 小时前
排队免单系统底层设计:四种分配算法拆解,无预支资金的合规营销架构方案
java·前端·软件开发·商业模式·本地生活·商业思维