记一次UnavailableSecurityManagerException异常

约 2422 字大约 8 分钟

2024-10-20

解决思路

这个报错的原因花了一段时间查找，有如下几种可能：

org.apache.shiro.UnavailableSecurityManagerException 异常通常表示尝试获取 SecurityManager 时失败了，因为 SecurityManager 没有被正确地初始化或配置。这个异常可能由以下几个原因引起：

ShiroFilterFactoryBean 配置问题：如果你在使用 Spring 集成 Shiro 时遇到了这个问题，可能是因为 ShiroFilterFactoryBean 没有被正确配置。确保你已经将 ShiroFilterFactoryBean 设置为一个 @Bean，并在其内部设置了 SecurityManager。例如：

@Bean
public ShiroFilterFactoryBean shiroFilter(DefaultWebSecurityManager securityManager) {
    ShiroFilterFactoryBean shiroFilterFactoryBean = new ShiroFilterFactoryBean();
    shiroFilterFactoryBean.setSecurityManager(securityManager);
    // 其他配置...
    return shiroFilterFactoryBean;
}

DelegatingFilterProxy 配置问题：在 Spring Boot 应用中，如果你使用了 DelegatingFilterProxy 来代理 Shiro 的过滤器，确保你已经正确配置了这个代理。例如：

@Bean
public FilterRegistrationBean delegatingFilterProxy() {
    FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean();
    DelegatingFilterProxy proxy = new DelegatingFilterProxy();
    proxy.setTargetFilterLifecycle(true);
    proxy.setTargetBeanName("shiroFilter"); // 注意这里的 bean 名称要与 shiroFilterFactoryBean 的名称一致
    filterRegistrationBean.setFilter(proxy);
    return filterRegistrationBean;
}

SecurityManager 未注入：确保 SecurityManager 已经被注入到你的应用上下文中，并且可以通过 SecurityUtils 获取到。如果没有注入，你需要配置一个 SecurityManager 的 bean，并确保它被 ShiroFilterFactoryBean 使用。
Filter 执行顺序问题：如果你定义了自定义的过滤器，并且这些过滤器在 Shiro 的 ShiroFilterFactoryBean 之前执行，可能会导致 SecurityManager 未被正确设置。确保自定义过滤器是在 Shiro 过滤器之后执行的。
Spring Boot 集成问题：如果你在使用 Spring Boot 集成 Shiro，可能需要额外注意配置的细节。例如，确保你的 ShiroFilterFactoryBean bean 名称与 DelegatingFilterProxy 中指定的名称一致。
确保 Shiro 配置类被 Spring 管理：如果你的 Shiro 配置类没有被 Spring 管理，那么 SecurityManager 可能不会被正确初始化。确保你的配置类上有 @Configuration 注解。

如果问题依然存在，建议检查 Shiro 配置类中的所有 @Bean 方法，确保它们都正确配置，并且没有遗漏任何必要的设置。同时，检查应用程序的日志，查看是否有其他相关的错误信息，这可能会提供更多关于问题的线索。

也看看有没有配漏@Bean 疏忽导致。

解决方案

最终找到一个方案解决：

DelegatingFilterProxy 是 Spring 框架提供的一个非常有用的类，它的作用是将 Spring 容器管理的 Filter 代理为一个 Servlet Filter，这样就可以利用 Spring 的依赖注入和生命周期管理功能。这个代理类允许 Filter 实例享受 Spring 的依赖注入，并且可以通过 Spring 来管理 Filter 的生命周期。

在 Spring Boot 应用中，如果你使用了 Filter，并且希望这些 Filter 能够注入 Spring 容器中的其他组件，你可以通过 DelegatingFilterProxy 来实现。这样，你就可以在 Filter 中注入业务工具类或其他 Spring 管理的 Bean，而不会出现注入为 null 的问题。

关于 ShiroFilterFactoryBean 的配置，它是用来配置 Shiro 过滤器链的入口点。通过这个 Bean，你可以设置安全管理器、登录 URL、权限不足时的跳转 URL 等。同时，你还可以自定义过滤器，并将其加入到 Shiro 的过滤器链中。

在使用 Shiro 时，如果你遇到了 No SecurityManager accessible 这样的异常，通常是因为 Shiro 没有正确地获取到 SecurityManager 实例。这可能是因为 SecurityManager 没有被注册为 Spring 容器中的一个 Bean，或者 ShiroFilterFactoryBean 没有正确地设置 SecurityManager 属性。确保你在配置 Shiro 时，已经定义了一个 SecurityManager 的 Bean，并且通过 shiroFilterFactoryBean.setSecurityManager(securityManager()) 方法将其设置给了 ShiroFilterFactoryBean 。

最后，确保你的自定义过滤器没有被 Spring 容器重复管理。如果你的自定义过滤器被声明为一个 Spring Bean，并且也通过 FilterRegistrationBean 注册到了 Spring 容器中，那么它可能会被执行两次。为了避免这个问题，你可以选择不让 Spring 管理你的自定义过滤器，而是直接在 ShiroFilterFactoryBean 中通过 new 关键字创建实例。

总结

如果需要在 Filter 中使用 Spring 的特性，如依赖注入或生命周期管理，那么使用 DelegatingFilterProxy 是一个更好的选择。如果你的 Filter 不需要这些 Spring 特性，那么直接使用 Filter 可能是一个更简单直接的选择。

在 Shiro 与 Spring 集成时，通常建议使用 DelegatingFilterProxy 来代理 Shiro 的 Filter，这样可以确保 Shiro 的 Filter 能够享受到 Spring 的依赖注入和生命周期管理功能。例如，在 Spring 配置文件中配置 Shiro 的 ShiroFilterFactoryBean 时，可以通过 DelegatingFilterProxy 来确保 Shiro 的 Filter 被 Spring 容器管理。

更新日志

2026/5/5 18:40

查看所有更新日志

8bd98-docs: 添加 blog/04_ARCHIVES 归档文档于 2026/5/5

记一次UnavailableSecurityManagerException异常

问题背景

解决思路

解决方案

相关问题

为什么使用 DelegatingFilterProxy 而不是直接使用 Filter？

在 Spring 中，Filter 和 DelegatingFilterProxy 有什么区别？

总结

更新日志