SpringBoot ：如何使用 Sa-Token 完成权限认证

刺骨的言语ヽ痛彻心扉 2024-03-22 09:22 16阅读 0赞

![format_png][]

#### 一、设计思路 ####

所谓权限认证，核心逻辑就是判断一个账号是否拥有指定权限：

*  有，就让你通过。
 *  没有？那么禁止访问！

深入到底层数据中，就是每个账号都会拥有一个权限码集合，框架来校验这个集合中是否包含指定的权限码。

例如：当前账号拥有权限码集合 `["user-add", "user-delete", "user-get"]`，这时候我来校验权限 `"user-update"`，则其结果就是：**验证失败，禁止访问**。

动态演示图：![bbc9178db2004152b0566747bcaa3cd1.webp][]

所以现在问题的核心就是：

1.  如何获取一个账号所拥有的的权限码集合？
2.  本次操作需要验证的权限码是哪个？

接下来，我们将介绍在 SpringBoot 中如何使用 Sa-Token 完成权限认证操作。

> Sa-Token 是一个轻量级 java 权限认证框架，主要解决登录认证、权限认证、单点登录、OAuth2、微服务网关鉴权 等一系列权限相关问题。

首先在项目中引入 Sa-Token 依赖：

<dependency>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-spring-boot-starter</artifactId>
        <version>1.34.0</version>
    </dependency>
    复制代码

注：如果你使用的是 `SpringBoot 3.x`，只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。

#### 二、获取当前账号权限码集合 ####

因为每个项目的需求不同，其权限设计也千变万化，因此 \[ 获取当前账号权限码集合 \] 这一操作不可能内置到框架中， 所以 Sa-Token 将此操作以接口的方式暴露给你，以方便你根据自己的业务逻辑进行重写。

你需要做的就是新建一个类，实现 `StpInterface`接口，例如以下代码：

/**
     * 自定义权限验证接口扩展
     */
    @Component	// 保证此类被SpringBoot扫描，完成Sa-Token的自定义权限验证扩展 
    public class StpInterfaceImpl implements StpInterface {
    
    	/**
    	 * 返回一个账号所拥有的权限码集合 
    	 */
    	@Override
    	public List<String> getPermissionList(Object loginId, String loginType) {
    		// 本list仅做模拟，实际项目中要根据具体业务逻辑来查询权限
    		List<String> list = new ArrayList<String>();	
    		list.add("101");
    		list.add("user.add");
    		list.add("user.update");
    		list.add("user.get");
    		// list.add("user.delete");
    		list.add("art.*");
    		return list;
    	}
    
    	/**
    	 * 返回一个账号所拥有的角色标识集合 (权限与角色可分开校验)
    	 */
    	@

[format_png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/4a64de122d2f46859dfce3bb8771d213.png
[bbc9178db2004152b0566747bcaa3cd1.webp]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/32cad299af24416a9be003530339def5.png