> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/extend/sensitive.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-0fe1e04bb800-cover.svg)
- - -
功能说明
系统基于 Jackson 序列化策略,对标注 @Sensitive 的字段进行脱敏处理。
补充说明:
- 脱敏发生在接口响应序列化阶段,因此通常用于“返回给前端时隐藏敏感信息”,不会直接改动数据库中的原始值。
- 常见适用字段包括手机号、身份证号、邮箱、银行卡号、住址等。
使用方式
在字段上标注 @Sensitive,并指定策略与权限:

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

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

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

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

补充说明:
- 如果项目对“管理员是否可见明文”的规则有特殊要求,可以通过
SensitiveService的实现统一调整,而不是到每个字段单独分支判断。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-0fe1e04bb800-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。