开发问题：记配置 shiro 排除路径失效的问题
by emanjusaka from https://www.emanjusaka.top/2024/08/record-shiro-exclude-path-hashmap 彼岸花开可奈何
本文为原创文章，可能会更新知识点以及修正文中的一些错误，全文转载请保留原文地址，避免未即时修正的错误误导。
一、问题背景
上周一个使用 shiro 的项目在yaml 配置文件中新增了一条排除路径（即不需要进行安全验证的路径）的时候，发现不但新配置的路径不生效之前生效的排除路径也有部分失效了。而且颇为神奇的是在 yaml 中配置 5 条以上的排除路径就会产生问题，不超过 5 条以上问题未出现。回顾了下代码并没有任何限制数量的东西。
二、关键代码
在这里展示部分关键代码，相关不便于展示部分已隐藏或修改。
yaml 配置文件
security:
cloud:
onlyFetchByGateway: true
excludePath:
- /logout/**
- /sso/**
- /getSecretKey
- /checkLogin/**
- /getSetting/**
- /ukey/**正如上面所示最后一条路径是新增的，增加完出现问题。
shiro 配置代码
@Bean
public ShiroFilterFactoryBean shiroFilterFactoryBean(SecurityManager securityManager,
Properties properties) {
ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean();
Map<String, Filter> filters = shiroFilterFactoryBean.getFilters();
filters.put("authc", new CustomUserFilter(redisTemplate,cloudSecurityProperties));
shiroFilterFactoryBean.setSecurityManager(securityManager);
Map<String, String> map = new HashMap<>();
//登出
map.put("/logout", "logout");
map.put("/oauthxxx/**", "anon");
map.put("/dataxx/**", "anon");
map.put("/auth/callxxx/**", "anon");
map.put("/auth/getxxx/**", "anon");
map.put("/party/createxxx/**", "anon");
List<String> excludePath = properties.getExcludePath();
if (CollUtil.isNotEmpty(excludePath)) {
for (String path : excludePath) {
map.put(path, "anon");
}
}
//对所有用户认证
map.put("/**", "authc");
shiroFilterFactoryBean.setFilterChainDefinitionMap(map);
return shiroFilterFactoryBean;
}三、问题探究
上面展示了部分关键代码，初看的时候并没有发现什么问题。当看到map.put("/**", "authc");这行代码突然意识到这个要放到最后一个的，否则在它后面的排除路径是无效的。再去看这个 map 发现使用的是 HashMap，顿时灵光一闪HashMap 是无序的会不会是它导致的问题出现。马上修改代码把 HashMap 改为有序的 LinkedHashMap，经过实际验证发现问题解决。
果然一些基础知识的掌握一定要牢靠，否则会导致问题解决花费很长时间。如果不能第一时间就意识到 HashMap 是无序的，那这个问题可能会花费更长的时间，甚至于都不能解决。
四、深入研究
秉着有任何疑问都要打破砂锅问到底的态度，为啥在 yaml 中配置 5 条以上的排除路径就会产生问题，不超过 5 条以上问题未出现呢？
我们都知道 HashMap 的初始默认容量是 16，它的默认扩容因子为 0.75，当容量达到 12（16 x 0.75）时，HashMap 会进行扩容。扩容过程涉及创建一个新的内部数组，其大小通常是原始大小的两倍，并重新分布（或称为“再哈希”）所有现有的键值对到这个新数组中。
上面代码map 已经有了 7 条数据，而 yaml 配置文件中的排除路径超过 5 个时，它们加在一起就会超过 12 触发扩容机制。重新分布后这时顺序可能就会不在一样。而map.put("/**", "authc");跑到了前面的时候，在它后面的排除路径就会全部失效。
在技术的星河中遨游，我们互为引路星辰，共同追逐成长的光芒。愿本文的洞见能触动您的思绪，若有所共鸣，请以点赞之手，轻抚赞同的弦。
原文地址： https://www.emanjusaka.top/2024/08/record-shiro-exclude-path-hashmap
微信公众号：emanjusaka的编程栈
