SpringBoot集成Shiro极简教程（实战版）

快来打我* 2023-01-14 11:00 124阅读 0赞

![46c966626c70d2a0d1a9405a8882ac3d.png][]

*来源：juejin.cn/post/6844903887871148039*

## 1. 前言 ##

Apache Shiro是一个功能强大且易于使用的Java安全框架，提供了认证，授权，加密，和会话管理。

![cb7a410434cb402bc729c898e3add2a2.png][]

Shiro有三大核心组件：

*  **Subject：** 即当前用户，在权限管理的应用程序里往往需要知道谁能够操作什么，谁拥有操作该程序的权利，shiro中则需要通过Subject来提供基础的当前用户信息，Subject 不仅仅代表某个用户，与当前应用交互的任何东西都是Subject，如网络爬虫等。所有的Subject都要绑定到SecurityManager上，与Subject的交互实际上是被转换为与SecurityManager的交互。
 *  **SecurityManager：** 即所有Subject的管理者，这是Shiro框架的核心组件，可以把他看做是一个Shiro框架的全局管理组件，用于调度各种Shiro框架的服务。作用类似于SpringMVC中的DispatcherServlet，用于拦截所有请求并进行处理。
 *  **Realm：** Realm是用户的信息认证器和用户的权限人证器，我们需要自己来实现Realm来自定义的管理我们自己系统内部的权限规则。SecurityManager要验证用户，需要从Realm中获取用户。可以把Realm看做是数据源。

## 2. 数据库设计 ##

### 2.1 User(用户) ###

![206755579290b6b2cbb18e67e3bd620e.png][]

SET NAMES utf8mb4;
    SET FOREIGN_KEY_CHECKS = 0;
    
    -- ----------------------------
    -- Table structure for user
    -- ----------------------------
    DROP TABLE IF EXISTS `user`;
    CREATE TABLE `user`  (
      `id` bigint(20) NOT NULL AUTO_INCREMENT,
      `password` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
      `username` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
      `account` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
      PRIMARY KEY (`id`) USING BTREE
    ) ENGINE = MyISAM AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;
    
    -- ----------------------------
    -- Records of user
    -- ----------------------------
    INSERT INTO `user` VALUES (1, 'root', '超级用户', 'root');
    INSERT INTO `user` VALUES (2, 'user', '普通用户', 'user');
    INSERT INTO `user` VALUES (3, 'vip', 'VIP用户', 'vip');
    
    SET FOREIGN_KEY_CHECKS = 1;

### 2.2 Role(角色) ###

![70b2f8b62ed2af9ba86342b073b79b3b.png][]

SET NAMES utf8mb4;
    SET FOREIGN_KEY_CHECKS = 0;
    
    -- ----------------------------
    -- Table structure for role
    -- ----------------------------
    DROP TABLE IF EXISTS `role`;
    CREATE TABLE `role`  (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `role` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
      `desc` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
      PRIMARY KEY (`id`) USING BTREE
    ) ENGINE = MyISAM AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;
    
    -- ----------------------------
    -- Records of role
    -- ----------------------------
    INSERT INTO `role` VALUES (1, 'admin', '超级管理员');
    INSERT INTO `role` VALUES (2, 'user', '普通用户');
    INSERT INTO `role` VALUES (3, 'vip_user', 'VIP用户');
    
    SET FOREIGN_KEY_CHECKS = 1;

### 2.3 Permission(权限) ###

![64871fee0430b2476dec3b371349715e.png][]

SET NAMES utf8mb4;
    SET FOREIGN_KEY_CHECKS = 0;
    
    -- ----------------------------
    -- Table structure for permission
    -- ----------------------------
    DROP TABLE IF EXISTS `permission`;
    CREATE TABLE `permission`  (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `permission` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '权限名称',
      `desc` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '权限描述',
      PRIMARY KEY (`id`) USING BTREE
    ) ENGINE = MyISAM AUTO_INCREMENT = 5 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;
    
    -- ----------------------------
    -- Records of permission
    -- ----------------------------
    INSERT INTO `permission` VALUES (1, 'add', '增加');
    INSERT INTO `permission` VALUES (2, 'update', '更新');
    INSERT INTO `permission` VALUES (3, 'select', '查看');
    INSERT INTO `permission` VALUES (4, 'delete', '删除');
    
    SET FOREIGN_KEY_CHECKS = 1;

### 2.4 User\_Role(用户-角色) ###

![88f4be265a9e65a1173ad99aa1f0d5e4.png][]

SET NAMES utf8mb4;
    SET FOREIGN_KEY_CHECKS = 0;
    
    -- ----------------------------
    -- Table structure for user_role
    -- ----------------------------
    DROP TABLE IF EXISTS `user_role`;
    CREATE TABLE `user_role`  (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `user_id` int(11) NULL DEFAULT NULL,
      `role_id` int(11) NULL DEFAULT NULL,
      PRIMARY KEY (`id`) USING BTREE
    ) ENGINE = MyISAM AUTO_INCREMENT = 4 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Fixed;
    
    -- ----------------------------
    -- Records of user_role
    -- ----------------------------
    INSERT INTO `user_role` VALUES (1, 1, 1);
    INSERT INTO `user_role` VALUES (2, 2, 2);
    INSERT INTO `user_role` VALUES (3, 3, 3);
    
    SET FOREIGN_KEY_CHECKS = 1;

### 2.5 Role\_Permission(角色-权限) ###

![41ab769fad4a12276bd971a88733fbbd.png][]

SET NAMES utf8mb4;
    SET FOREIGN_KEY_CHECKS = 0;
    
    -- ----------------------------
    -- Table structure for role_permission
    -- ----------------------------
    DROP TABLE IF EXISTS `role_permission`;
    CREATE TABLE `role_permission`  (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `role_id` int(11) NULL DEFAULT NULL,
      `permission_id` int(255) NULL DEFAULT NULL,
      PRIMARY KEY (`id`) USING BTREE
    ) ENGINE = MyISAM AUTO_INCREMENT = 9 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Fixed;
    
    -- ----------------------------
    -- Records of role_permission
    -- ----------------------------
    INSERT INTO `role_permission` VALUES (1, 1, 1);
    INSERT INTO `role_permission` VALUES (2, 1, 2);
    INSERT INTO `role_permission` VALUES (3, 1, 3);
    INSERT INTO `role_permission` VALUES (4, 1, 4);
    INSERT INTO `role_permission` VALUES (5, 2, 3);
    INSERT INTO `role_permission` VALUES (6, 3, 3);
    INSERT INTO `role_permission` VALUES (7, 3, 2);
    INSERT INTO `role_permission` VALUES (8, 2, 1);
    
    SET FOREIGN_KEY_CHECKS = 1;

## 3. 项目结构 ##

![3cdf212697dc0f814fb1f8dc59028d7c.png][]

## 4. 前期准备 ##

### 4.1 导入Pom ###

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
    </dependency>
    
    <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
    </dependency>
    
    <dependency>
            <groupId>org.apache.shiro</groupId>
            <artifactId>shiro-spring</artifactId>
            <version>1.4.0</version>
    </dependency>

### 4.2 application.yml ###

server:
      port: 8903
    spring:
      application:
        name: lab-user
      datasource:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://127.0.0.1:3306/laboratory?charset=utf8
        username: root
        password: root
    mybatis:
      type-aliases-package: cn.ntshare.laboratory.entity
      mapper-locations: classpath:mapper/*.xml
      configuration:
        map-underscore-to-camel-case: true

### 4.3 实体类 ###

#### 4.3.1 User.java ####

@Data
    @ToString
    public class User implements Serializable {
    
        private static final long serialVersionUID = -6056125703075132981L;
    
        private Integer id;
    
        private String account;
    
        private String password;
    
        private String username;
    }

#### 4.3.2 Role.java ####

@Data
    @ToString
    public class Role implements Serializable {
    
        private static final long serialVersionUID = -1767327914553823741L;
    
        private Integer id;
    
        private String role;
    
        private String desc;
    }

### 4.4 Dao层 ###

#### 4.4.1 PermissionMapper.java ####

@Mapper
    @Repository
    public interface PermissionMapper {
    
        List<String> findByRoleId(@Param("roleIds") List<Integer> roleIds);
    }

#### 4.4.2 PermissionMapper.xml ####

<mapper namespace="cn.ntshare.laboratory.dao.PermissionMapper">
        <sql id="base_column_list">
            id, permission, desc
        </sql>
    
        <select id="findByRoleId" parameterType="List" resultType="String">
            select permission
            from permission, role_permission rp
            where rp.permission_id = permission.id and rp.role_id in
            <foreach collection="roleIds" item="id" open="(" close=")" separator=",">
                #{id}
            </foreach>
        </select>
    </mapper>

#### 4.4.3 RoleMapper.java ####

@Mapper
    @Repository
    public interface RoleMapper {
    
        List<Role> findRoleByUserId(@Param("userId") Integer userId);
    }

#### 4.4.4 RoleMapper.xml ####

<mapper namespace="cn.ntshare.laboratory.dao.RoleMapper">
        <sql id="base_column_list">
            id, user_id, role_id
        </sql>
    
        <select id="findRoleByUserId" parameterType="Integer" resultType="Role">
            select role.id, role
            from role, user, user_role ur
            where role.id = ur.role_id and ur.user_id = user.id and user.id = #{userId}
        </select>
    </mapper>

#### 4.4.5 UserMapper.java ####

@Mapper
    @Repository
    public interface UserMapper {
        User findByAccount(@Param("account") String account);
    }

#### 4.4.6 UserMapper.xml ####

<mapper namespace="cn.ntshare.laboratory.dao.UserMapper">
    
        <sql id="base_column_list">
            id, account, password, username
        </sql>
    
        <select id="findByAccount" parameterType="Map" resultType="User">
            select
            <include refid="base_column_list"/>
            from user
            where account = #{account}
        </select>
    </mapper>

### 4.5 Service层 ###

#### 4.5.1 PermissionServiceImpl.java ####

@Service
    public class PermissionServiceImpl implements PermissionService {
    
        @Autowired
        private PermissionMapper permissionMapper;
    
        @Override
        public List<String> findByRoleId(List<Integer> roleIds) {
            return permissionMapper.findByRoleId(roleIds);
        }
    }

#### 4.5.2 RoleServiceImpl.java ####

@Service
    public class RoleServiceImpl implements RoleService {
    
        @Autowired
        private RoleMapper roleMapper;
    
        @Override
        public List<Role> findRoleByUserId(Integer id) {
            return roleMapper.findRoleByUserId(id);
        }
    }

#### 4.5.3 UserServiceImpl.java ####

@Service
    public class UserServiceImpl implements UserService {
    
        @Autowired
        private UserMapper userMapper;
    
        @Override
        public User findByAccount(String account) {
            return userMapper.findByAccount(account);
        }
    }

### 4.6. 系统返回状态枚举与包装函数 ###

#### 4.6.1 ServerResponseEnum.java ####

@AllArgsConstructor
    @Getter
    public enum ServerResponseEnum {
        SUCCESS(0, "成功"),
        ERROR(10, "失败"),
    
        ACCOUNT_NOT_EXIST(11, "账号不存在"),
        DUPLICATE_ACCOUNT(12, "账号重复"),
        ACCOUNT_IS_DISABLED(13, "账号被禁用"),
        INCORRECT_CREDENTIALS(14, "账号或密码错误"),
        NOT_LOGIN_IN(15, "账号未登录"),
        UNAUTHORIZED(16, "没有权限")
        ;
        Integer code;
        String message;
    }

#### 4.6.2 ServerResponseVO.java ####

@Getter
    @Setter
    @NoArgsConstructor
    public class ServerResponseVO<T> implements Serializable {
        private static final long serialVersionUID = -1005863670741860901L;
        // 响应码
        private Integer code;
    
        // 描述信息
        private String message;
    
        // 响应内容
        private T data;
    
        private ServerResponseVO(ServerResponseEnum responseCode) {
            this.code = responseCode.getCode();
            this.message = responseCode.getMessage();
        }
    
        private ServerResponseVO(ServerResponseEnum responseCode, T data) {
            this.code = responseCode.getCode();
            this.message = responseCode.getMessage();
            this.data = data;
        }
    
        private ServerResponseVO(Integer code, String message) {
            this.code = code;
            this.message = message;
        }
    
        /**
         * 返回成功信息
         * @param data      信息内容
         * @param <T>
         * @return
         */
        public static<T> ServerResponseVO success(T data) {
            return new ServerResponseVO<>(ServerResponseEnum.SUCCESS, data);
        }
    
        /**
         * 返回成功信息
         * @return
         */
        public static ServerResponseVO success() {
            return new ServerResponseVO(ServerResponseEnum.SUCCESS);
        }
    
        /**
         * 返回错误信息
         * @param responseCode      响应码
         * @return
         */
        public static ServerResponseVO error(ServerResponseEnum responseCode) {
            return new ServerResponseVO(responseCode);
        }
    }

### 4.7 统一异常处理 ###

当用户身份认证失败时，会抛出UnauthorizedException，我们可以通过统一异常处理来处理该异常

@RestControllerAdvice
    public class UserExceptionHandler {
    
        @ExceptionHandler(UnauthorizedException.class)
        @ResponseStatus(HttpStatus.UNAUTHORIZED)
        public ServerResponseVO UnAuthorizedExceptionHandler(UnauthorizedException e) {
            return ServerResponseVO.error(ServerResponseEnum.UNAUTHORIZED);
        }
    }

## 5. 集成Shiro ##

### 5.1 UserRealm.java ###

/**
     * 负责认证用户身份和对用户进行授权
     */
    public class UserRealm extends AuthorizingRealm {
    
        @Autowired
        private UserService userService;
    
        @Autowired
        private RoleService roleService;
    
        @Autowired
        private PermissionService permissionService;
    
        // 用户授权
        protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principalCollection) {
            User user = (User) principalCollection.getPrimaryPrincipal();
            SimpleAuthorizationInfo authorizationInfo = new SimpleAuthorizationInfo();
            List<Role> roleList = roleService.findRoleByUserId(user.getId());
            Set<String> roleSet = new HashSet<>();
            List<Integer> roleIds = new ArrayList<>();
            for (Role role : roleList) {
                roleSet.add(role.getRole());
                roleIds.add(role.getId());
            }
            // 放入角色信息
            authorizationInfo.setRoles(roleSet);
            // 放入权限信息
            List<String> permissionList = permissionService.findByRoleId(roleIds);
            authorizationInfo.setStringPermissions(new HashSet<>(permissionList));
    
            return authorizationInfo;
        }
    
        // 用户认证
        protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken authToken) throws AuthenticationException {
            UsernamePasswordToken token = (UsernamePasswordToken) authToken;
            User user = userService.findByAccount(token.getUsername());
            if (user == null) {
                return null;
            }
            return new SimpleAuthenticationInfo(user, user.getPassword(), getName());
        }
    }

### 5.2 ShiroConfig.java ###

@Configuration
    public class ShiroConfig {
    
        @Bean
        public UserRealm userRealm() {
            return new UserRealm();
        }
    
        @Bean
        public DefaultWebSecurityManager securityManager() {
            DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager();
            securityManager.setRealm(userRealm());
            return securityManager;
        }
    
        /**
         * 路径过滤规则
         * @return
         */
        @Bean
        public ShiroFilterFactoryBean shiroFilter(DefaultWebSecurityManager securityManager) {
            ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean();
            shiroFilterFactoryBean.setSecurityManager(securityManager);
    
            shiroFilterFactoryBean.setLoginUrl("/login");
            shiroFilterFactoryBean.setSuccessUrl("/");
            Map<String, String> map = new LinkedHashMap<>();
            // 有先后顺序
            map.put("/login", "anon");      // 允许匿名访问
            map.put("/**", "authc");        // 进行身份认证后才能访问
            shiroFilterFactoryBean.setFilterChainDefinitionMap(map);
            return shiroFilterFactoryBean;
        }
    
        /**
         * 开启Shiro注解模式，可以在Controller中的方法上添加注解
         * @param securityManager
         * @return
         */
        @Bean
        public AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor(@Qualifier("securityManager") DefaultSecurityManager securityManager) {
            AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor = new AuthorizationAttributeSourceAdvisor();
            authorizationAttributeSourceAdvisor.setSecurityManager(securityManager);
            return authorizationAttributeSourceAdvisor;
        }

### 5.3 LoginController.java ###

@RestController
    @RequestMapping("")
    public class LoginController {
    
        @PostMapping("/login")
        public ServerResponseVO login(@RequestParam(value = "account") String account,
                                      @RequestParam(value = "password") String password) {
            Subject userSubject = SecurityUtils.getSubject();
            UsernamePasswordToken token = new UsernamePasswordToken(account, password);
            try {
                // 登录验证
                userSubject.login(token);
                return ServerResponseVO.success();
            } catch (UnknownAccountException e) {
                return ServerResponseVO.error(ServerResponseEnum.ACCOUNT_NOT_EXIST);
            } catch (DisabledAccountException e) {
                return ServerResponseVO.error(ServerResponseEnum.ACCOUNT_IS_DISABLED);
            } catch (IncorrectCredentialsException e) {
                return ServerResponseVO.error(ServerResponseEnum.INCORRECT_CREDENTIALS);
            } catch (Throwable e) {
                e.printStackTrace();
                return ServerResponseVO.error(ServerResponseEnum.ERROR);
            }
        }
    
        @GetMapping("/login")
        public ServerResponseVO login() {
            return ServerResponseVO.error(ServerResponseEnum.NOT_LOGIN_IN);
        }
    
        @GetMapping("/auth")
        public String auth() {
            return "已成功登录";
        }
    
        @GetMapping("/role")
        @RequiresRoles("vip")
        public String role() {
            return "测试Vip角色";
        }
    
        @GetMapping("/permission")
        @RequiresPermissions(value = {"add", "update"}, logical = Logical.AND)
        public String permission() {
            return "测试Add和Update权限";
        }
    }

## 6. 测试 ##

### 6.1 用root用户登录 ###

#### 6.1.1 登录 ####

![b1d102fd4745631343384369e388edaa.png][]

#### 6.1.2 验证是否登录 ####

![6fd43f3b8b3ee119898c7519910fc729.png][]

#### 6.1.3 测试角色权限 ####

![47938a3c0e4b9665105da071f6893906.png][]

#### 6.1.4 测试用户操作权限 ####

![c5077d8e61d8d14b1b702522bf0eca49.png][]

#### 6.2 user用户和vip用户测试略 ####

## 7. 总结 ##

本文演示了SpringBoot极简集成Shiro框架，实现了基础的身份认证和授权功能，如有不足，请多指教。

后续可扩展的功能点有：

*  集成Redis实现Shiro的分布式会话
 *  集成JWT实现单点登录功能

推荐好文

[强大，10k+点赞的 SpringBoot 后台管理系统竟然出了详细教程！][10k_ SpringBoot]

[分享一套基于SpringBoot和Vue的企业级中后台开源项目，代码很规范！][SpringBoot_Vue]

[能挣钱的，开源 SpringBoot 商城系统，功能超全，超漂亮][SpringBoot]![96da6063460b5b651cddfe03d93f132c.png][]

[46c966626c70d2a0d1a9405a8882ac3d.png]: /images/20221022/e1c5569971ae481f9339f1a4d64d4709.png
[cb7a410434cb402bc729c898e3add2a2.png]: /images/20221022/43925f0049f0418c8951f92a826a78f3.png
[206755579290b6b2cbb18e67e3bd620e.png]: /images/20221022/5c044908c2d8414aac34fc9d8fa8343e.png
[70b2f8b62ed2af9ba86342b073b79b3b.png]: /images/20221022/33a0f0f7233e4e75be7b440aab9611ab.png
[64871fee0430b2476dec3b371349715e.png]: /images/20221022/c138fc3749d54f1782c15a249087843e.png
[88f4be265a9e65a1173ad99aa1f0d5e4.png]: /images/20221022/b9cf881a06d944d9b19ed52aa11e2687.png
[41ab769fad4a12276bd971a88733fbbd.png]: /images/20221022/d0057d409d2441f6a6e8b0262e6a3114.png
[3cdf212697dc0f814fb1f8dc59028d7c.png]: /images/20221022/55b849632494418ea60d6afa23d93533.png
[b1d102fd4745631343384369e388edaa.png]: /images/20221022/811dd3e27faf44368b1e7c857cca70c6.png
[6fd43f3b8b3ee119898c7519910fc729.png]: /images/20221022/2f8c7254b9974111a5f2e9c4132ee715.png
[47938a3c0e4b9665105da071f6893906.png]: /images/20221022/80c3da5ea4b04198b8b69e10ea09a96c.png
[c5077d8e61d8d14b1b702522bf0eca49.png]: /images/20221022/b4b7cf5bc30c41c4b702070317a2cb39.png
[10k_ SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzI4Njc5NjM1NQ%3D%3D&chksm=ebd5c411dca24d07446a4f22772cd12d2cc1143b62eb922a14500ae981cd57fb850ef74ca257&idx=2&mid=2247498557&scene=21&sn=84902d7030e174e152615d8fae3755cc#wechat_redirect
[SpringBoot_Vue]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799be6cb0e12f0b58479f8b031bc5ae79efdca1880ff9b19f0a107c3a88c37b9596dc73203&idx=2&mid=2247497288&scene=21&sn=65d7111a19e920df1e9416959594b2f4#wechat_redirect
[SpringBoot]: http://mp.weixin.qq.com/s?__biz=MzU2MTI4MjI0MQ%3D%3D&chksm=fc799a9ccb0e138a64a2671f31b8d4be1b3c061a288f7b0d1d4af02a60c45a72231446b91e00&idx=2&mid=2247497522&scene=21&sn=c5b4e596be4ac7d7f293e7e2f0ea0769#wechat_redirect
[96da6063460b5b651cddfe03d93f132c.png]: /images/20221022/d290ace9da274173ac40308597daeac5.png