若依(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 无权限 ≠ 没配权限,而是"配得不对"或"没生效"!

只要做到:

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

就能彻底解决权限问题!

相关推荐
lichenyang45316 小时前
Docker 学习笔记(一):为什么需要镜像、容器和仓库?
前端
kyriewen16 小时前
别再对着 TypeScript 报错发呆了:我把 10 个最常见的红色波浪线翻译成了人话
前端·javascript·typescript
IT_陈寒17 小时前
SpringBoot自动配置的坑,我的API突然就404了
前端·人工智能·后端
奇奇怪怪的17 小时前
Embedding 模型 10+ 横向评测
前端
陈广亮17 小时前
Monorepo 从 0 到 1 实操指南 2026 版:pnpm catalogs + Turborepo 2.x + changesets 全链路
前端
子兮曰17 小时前
OpenMontage 深度解剖:你的 AI 编程助手,其实是个视频工作室
前端·后端·ai编程
敲代码的鱼17 小时前
PDF 预览与签名批注写回 支持安卓 iOS 鸿蒙 UTS插件
android·前端·ios
子兮曰18 小时前
前端工具链的「Rust 化」:一场没有赢家的军备竞赛?
前端·后端·rust
Hyyy19 小时前
Function Calling / Tool Use的原理和实现模式
前端·llm·ai编程