前端权限管理实现：别让用户看到不该看的东西！

优质文章学习记录

— 8 min read

前端权限管理实现：别让用户看到不该看的东西！

毒舌时刻

权限管理？听起来就像是前端工程师为了显得自己很专业而特意搞的一套复杂流程。你以为随便加个if语句就能实现权限管理？别做梦了！到时候你会发现，权限逻辑分散在各个组件中，难以维护。

你以为前端权限管理就是最终的安全保障？别天真了！前端权限管理只是为了提高用户体验，真正的安全保障在后端。还有那些所谓的权限管理库，看起来高大上，用起来却各种问题。

为什么你需要这个

  1. 用户体验：良好的权限管理可以为不同角色的用户提供不同的界面，提高用户体验。
  2. 安全性：前端权限管理可以防止用户访问不该访问的功能，提高应用的安全性。
  3. 代码组织：集中的权限管理可以使代码结构更清晰，便于维护。
  4. 可扩展性：良好的权限管理设计可以方便地添加新的角色和权限。
  5. 合规性：某些行业和地区要求应用必须实现严格的权限控制。

反面教材

// 1. 分散的权限逻辑 function AdminPanel() { const user = useUser(); if (user.role !== 'admin') { return <div>Access denied</div>; } return <div>Admin Panel</div>; } function UserProfile() { const user = useUser(); const userId = useParams().id; if (user.role !== 'admin' && user.id !== userId) { return <div>Access denied</div>; } return <div>User Profile</div>; } // 2. 硬编码权限 function Menu() { const user = useUser(); return ( <nav> <ul> <li><a href="/">Home</a></li> {user.role === 'admin' && <li><a href="/admin">Admin</a></li>} {user.role === 'user' && <li><a href="/profile">Profile</a></li>} {user.role === 'guest' && <li><a href="/login">Login</a></li>} </ul> </nav> ); } // 3. 缺少权限检查 function DeleteUser() { const { userId } = useParams(); const handleDelete = async () => { await fetch(`/api/users/${userId}`, { method: 'DELETE' }); }; return <button onClick={handleDelete}>Delete User</button>; } // 4. 权限管理混乱 const roles = { admin: ['create', 'read', 'update', 'delete'], user: ['read', 'update'], guest: ['read'] }; function checkPermission(user, resource, action) { if (!user || !user.role) { return false; } const rolePermissions = roles[user.role]; return rolePermissions.includes(action); } // 5. 缺少权限状态管理 function ProtectedRoute({ children, requiredRole }) { const user = useUser(); if (!user || user.role !== requiredRole) { return <Redirect to="/login" />; } return children; }

问题：

  • 权限逻辑分散在各个组件中，难以维护
  • 硬编码权限，难以扩展
  • 缺少权限检查，存在安全隐患
  • 权限管理混乱，难以理解
  • 缺少权限状态管理，用户体验差

正确的做法

权限管理设计

// 1. 权限配置 const permissions = { roles: { admin: { name: 'Admin', permissions: ['users:create', 'users:read', 'users:update', 'users:delete', 'dashboard:access'] }, user: { name: 'User', permissions: ['users:read', 'users:update', 'profile:access'] }, guest: { name: 'Guest', permissions: ['login:access', 'register:access'] } }, resources: { users: { name: 'Users', actions: ['create', 'read', 'update', 'delete'] }, dashboard: { name: 'Dashboard', actions: ['access'] }, profile: { name: 'Profile', actions: ['access', 'update'] }, login: { name: 'Login', actions: ['access'] }, register: { name: 'Register', actions: ['access'] } } }; // 2. 权限检查函数 function checkPermission(user, resource, action) { if (!user || !user.role) { return false; } const rolePermissions = permissions.roles[user.role]?.permissions || []; const permissionKey = `${resource}:${action}`; return rolePermissions.includes(permissionKey); } // 3. 角色检查函数 function checkRole(user, requiredRole) { if (!user || !user.role) { return false; } return user.role === requiredRole; } // 4. 权限管理钩子 import { useContext } from 'react'; import { AuthContext } from './AuthContext'; export function usePermission() { const { user } = useContext(AuthContext); return { hasPermission: (resource, action) => checkPermission(user, resource, action), hasRole: (role) => checkRole(user, role), user }; }

路由权限管理

// 1. 受保护的路由组件 import React from 'react'; import { Navigate, useLocation } from 'react-router-dom'; import { usePermission } from './usePermission'; export function ProtectedRoute({ children, requiredPermissions = [], requiredRole = null }) { const { hasPermission, hasRole, user } = usePermission(); const location = useLocation(); // 检查角色 if (requiredRole && !hasRole(requiredRole)) { return <Navigate to="/unauthorized" state={{ from: location }} replace />; } // 检查权限 if (requiredPermissions.length > 0) { const hasAllPermissions = requiredPermissions.every(({ resource, action }) => hasPermission(resource, action) ); if (!hasAllPermissions) { return <Navigate to="/unauthorized" state={{ from: location }} replace />; } } return children; } // 2. 路由配置 import { createBrowserRouter } from 'react-router-dom'; import ProtectedRoute from './ProtectedRoute'; import Home from './pages/Home'; import Admin from './pages/Admin'; import Profile from './pages/Profile'; import Login from './pages/Login'; import Unauthorized from './pages/Unauthorized'; const router = createBrowserRouter([ { path: '/', element: <Home /> }, { path: '/admin', element: ( <ProtectedRoute requiredRole="admin"> <Admin /> </ProtectedRoute> ) }, { path: '/profile', element: ( <ProtectedRoute requiredPermissions={[{ resource: 'profile', action: 'access' }]}> <Profile /> </ProtectedRoute> ) }, { path: '/login', element: <Login /> }, { path: '/unauthorized', element: <Unauthorized /> } ]);

UI权限管理

// 1. 权限控制组件 import React from 'react'; import { usePermission } from './usePermission'; export function PermissionGuard({ children, resource, action, fallback = null }) { const { hasPermission } = usePermission(); if (!hasPermission(resource, action)) { return fallback; } return children; } // 2. 角色控制组件 import React from 'react'; import { usePermission } from './usePermission'; export function RoleGuard({ children, role, fallback = null }) { const { hasRole } = usePermission(); if (!hasRole(role)) { return fallback; } return children; } // 3. 条件渲染 import React from 'react'; import { PermissionGuard } from './PermissionGuard'; import { RoleGuard } from './RoleGuard'; function UserActions({ userId }) { return ( <div> <PermissionGuard resource="users" action="update"> <button>Edit User</button> </PermissionGuard> <PermissionGuard resource="users" action="delete"> <button>Delete User</button> </PermissionGuard> </div> ); } function AdminMenu() { return ( <RoleGuard role="admin"> <nav> <ul> <li><a href="/admin/users">Users</a></li> <li><a href="/admin/dashboard">Dashboard</a></li> <li><a href="/admin/settings">Settings</a></li> </ul> </nav> </RoleGuard> ); }

权限状态管理

// 1. AuthContext import React, { createContext, useState, useEffect } from 'react'; export const AuthContext = createContext(); export function AuthProvider({ children }) { const [user, setUser] = useState(null); const [loading, setLoading] = useState(true); useEffect(() => { // 从 localStorage 或 API 获取用户信息 const fetchUser = async () => { try { const userData = localStorage.getItem('user'); if (userData) { setUser(JSON.parse(userData)); } } catch (error) { console.error('Error fetching user:', error); } finally { setLoading(false); } }; fetchUser(); }, []); const login = async (credentials) => { // 登录逻辑 const response = await fetch('/api/login', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(credentials) }); const userData = await response.json(); setUser(userData); localStorage.setItem('user', JSON.stringify(userData)); return userData; }; const logout = () => { setUser(null); localStorage.removeItem('user'); }; return ( <AuthContext.Provider value={{ user, loading, login, logout }}> {children} </AuthContext.Provider> ); } // 2. 权限管理钩子 import { useContext } from 'react'; import { AuthContext } from './AuthContext'; import { checkPermission, checkRole } from './permissions'; export function usePermission() { const { user } = useContext(AuthContext); return { hasPermission: (resource, action) => checkPermission(user, resource, action), hasRole: (role) => checkRole(user, role), user }; } // 3. 权限状态更新 function updateUserPermissions(userId, permissions) { // 更新用户权限 return fetch(`/api/users/${userId}/permissions`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ permissions }) }) .then(response => response.json()) .then(data => { // 更新本地存储的用户信息 const user = JSON.parse(localStorage.getItem('user')); user.permissions = data.permissions; localStorage.setItem('user', JSON.stringify(user)); return data; }); }

最佳实践

// 1. 权限配置中心化 // permissions.js export const permissions = { roles: { admin: { name: 'Admin', permissions: ['users:create', 'users:read', 'users:update', 'users:delete', 'dashboard:access'] }, user: { name: 'User', permissions: ['users:read', 'users:update', 'profile:access'] }, guest: { name: 'Guest', permissions: ['login:access', 'register:access'] } } }; export function checkPermission(user, resource, action) { if (!user || !user.role) { return false; } const rolePermissions = permissions.roles[user.role]?.permissions || []; const permissionKey = `${resource}:${action}`; return rolePermissions.includes(permissionKey); } // 2. 权限管理组件化 // components/PermissionGuard.jsx import React from 'react'; import { usePermission } from '../hooks/usePermission'; export function PermissionGuard({ children, resource, action, fallback = null }) { const { hasPermission } = usePermission(); if (!hasPermission(resource, action)) { return fallback; } return children; } // 3. 路由权限统一管理 // routes.js import { createBrowserRouter } from 'react-router-dom'; import ProtectedRoute from './components/ProtectedRoute'; import Home from './pages/Home'; import Admin from './pages/Admin'; import Profile from './pages/Profile'; const router = createBrowserRouter([ { path: '/', element: <Home /> }, { path: '/admin', element: ( <ProtectedRoute requiredRole="admin"> <Admin /> </ProtectedRoute> ) }, { path: '/profile', element: ( <ProtectedRoute requiredPermissions={[{ resource: 'profile', action: 'access' }]}> <Profile /> </ProtectedRoute> ) } ]); // 4. 权限检查工具函数 // utils/permission.js export function canAccessRoute(user, route) { if (!route.requiredRole && !route.requiredPermissions) { return true; } if (route.requiredRole) { return user?.role === route.requiredRole; } if (route.requiredPermissions) { return route.requiredPermissions.every(({ resource, action }) => checkPermission(user, resource, action) ); } return false; } // 5. 权限状态管理 // hooks/usePermission.js import { useContext } from 'react'; import { AuthContext } from '../contexts/AuthContext'; import { checkPermission, checkRole } from '../utils/permissions'; export function usePermission() { const { user } = useContext(AuthContext); return { hasPermission: (resource, action) => checkPermission(user, resource, action), hasRole: (role) => checkRole(user, role), user }; }

毒舌点评

权限管理确实很重要，但我见过太多开发者滥用这个特性，导致应用变得过于复杂。

想象一下，当你为了实现权限管理，创建了大量的组件和钩子，结果导致代码量增加了几倍，这真的值得吗？

还有那些过度使用权限管理的开发者，为了控制每个按钮的权限，而忽略了用户体验，结果导致界面变得支离破碎。

所以，在实现权限管理时，一定要把握好度。不要为了权限管理而权限管理，要根据实际需求来决定权限管理的范围。

当然，对于需要严格权限控制的应用来说，完善的权限管理是必要的。但对于简单的应用，过度的权限管理反而会增加开发成本和维护难度。

最后，记住一句话：权限管理的目的是为了保护用户数据和提高用户体验，而不是为了炫技。如果你的权限管理实现导致用户体验变得更差，那你就失败了。

Read more

什么是 JWT？一文彻底搞懂 JSON Web Token（附 Spring Boot 实战）

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！ 你是否经常听到这些词： * “我们用 JWT 做登录认证” * “前端把 token 放在 Authorization 头里” * “JWT 无状态，适合分布式系统” 但你真的理解 JWT 到底是什么？它怎么工作？和 Session 有什么区别？ 吗？ 今天我们就用 通俗语言 + 图解 + Spring Boot 代码实战，带你从零彻底搞懂 JWT！ 🧩 一、一句话解释 JWT JWT（JSON Web Token）是一种开放标准（RFC 7519），用于在网络应用间安全地传递“声明”（claims）的紧凑、自包含令牌。 简单说：JWT 就是一个加密的字符串，里面包含了用户身份信息，

前端新手必看：CORS错误图解指南

快速体验 1. 打开 InsCode(快马)平台 https://www.inscode.net 2. 输入框内输入如下内容： 创建一个面向初学者的CORS教学项目：1) 用可视化方式展示浏览器同源策略；2) 提供3个最简单的解决方案示例(如修改Chrome启动参数、使用CORS插件等)；3) 每个方案要有步骤截图；4) 包含一个可交互的示例页面演示CORS错误和解决方案。使用最简单的语言说明。 1. 点击'项目生成'按钮，等待项目生成完整后预览效果 前端新手必看：CORS错误图解指南 最近在学习前端开发时，遇到了一个让人头疼的问题：浏览器控制台总是报错"HAS BEEN BLOCKED BY CORS POLICY: NO ACCESS-CONTROL-ALLOW-ORIGIN HEADER IS"。作为一个刚入门的新手，完全不明白这是什么意思。
【Elasticsearch】高亮搜索：从原理到Web呈现

【Elasticsearch】高亮搜索：从原理到Web呈现

🧑 博主简介：ZEEKLOG博客专家，历代文学网（PC端可以访问：https://literature.sinhy.com/#/?__c=1000，移动端可微信小程序搜索“历代文学”）总架构师，15年工作经验，精通Java编程，高并发设计，Springboot和微服务，熟悉Linux，ESXI虚拟化以及云原生Docker和K8s，热衷于探索科技的边界，并将理论知识转化为实际应用。保持对新技术的好奇心，乐于分享所学，希望通过我的实践经历和见解，启发他人的创新思维。在这里，我希望能与志同道合的朋友交流探讨，共同进步，一起在技术的世界里不断学习成长。 技术合作请加本人wx（注明来自ZEEKLOG）：foreast_sea

因为淋过雨，所以想给前端人说点真心话

我面过很多人，也被面过很多次。 从被问到“你连原型链都说不清”，到后来坐在桌子另一边面试别人。 今天这些话，是淋过雨之后，真想端给前端人的一碗汤。 一、关于面试：你以为考的是技术，其实考的是“能不能干活” 很多前端人准备面试，一头扎进： * 手写防抖节流 * 背Vue/React生命周期 * 刷LeetCode 这些当然要会，但面试官真正想确认的是三件事： 1. 把你丢进项目里，能不能独立负责一个模块 2. 遇到线上Bug，能不能快速定位 + 止损 3. 给你一个模糊需求，能不能拆解 + 落地 所以别再只背八股文了。 面试官一旦问“你做过什么”“怎么做的”“遇到什么困难”，就是在验证你能不能干活。 二、关于空白期：别怕Gap，怕的是“Gap但什么都没留下” 我面过一个女生，简历上写着“2024年3月至今：Gap Year”。 换作以前，我会犹豫。