后端框架 · RuoYi-Vue-Plus框架功能扩展功能
数据脱敏
功能说明
系统基于 Jackson 序列化策略,对标注 @Sensitive 的字段进行脱敏处理。
补充说明:
- 脱敏发生在接口响应序列化阶段,因此通常用于“返回给前端时隐藏敏感信息”,不会直接改动数据库中的原始值。
- 常见适用字段包括手机号、身份证号、邮箱、银行卡号、住址等。
使用方式
在字段上标注 @Sensitive,并指定策略与权限:

字段说明:
strategy:脱敏策略roleKey:角色 code(满足角色可查看明文)perms:权限 code(满足权限可查看明文)

补充说明:
- 如果同时配置了角色或权限放行条件,满足条件的用户可直接看到原文,不满足条件时才执行脱敏。
- 该能力适合做“同一接口对不同权限用户返回不同展示效果”的场景。
自定义脱敏策略
在 SensitiveStrategy 中新增策略实现:

脱敏逻辑调整
可通过通用接口自定义脱敏逻辑,支持不同系统使用不同规则。

默认逻辑:根据角色/权限或非管理员进行脱敏,可按需修改。

补充说明:
- 如果项目对“管理员是否可见明文”的规则有特殊要求,可以通过
SensitiveService的实现统一调整,而不是到每个字段单独分支判断。