Apache Shiro 2.0.0与Spring Boot 3.x集成问题解析

问题背景

在使用Apache Shiro 2.0.0与Spring Boot 3.x集成时，开发者可能会遇到java.lang.NoClassDefFoundError: javax/servlet/Filter的错误。这个问题源于Java EE向Jakarta EE的迁移过程中包名的变更，Spring Boot 3.x已经完全迁移到Jakarta EE规范。

错误原因分析

该错误的根本原因是Spring Boot 3.x使用的是Jakarta EE 9+规范，其中javax.servlet包已被重命名为jakarta.servlet。而如果直接使用未适配的Shiro版本，Shiro仍然会尝试加载旧的javax.servlet相关类，导致类加载失败。

解决方案

Apache Shiro从2.0.0版本开始提供了对Jakarta EE的适配版本，需要通过特定的classifier来使用：

1. 必须引入Shiro BOM：首先需要在dependencyManagement中引入Shiro的BOM(Bill of Materials)来管理依赖版本

2. 使用jakarta分类器：所有Shiro相关依赖都需要明确指定jakarta分类器

3. 完整依赖配置示例：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.shiro</groupId>
            <artifactId>shiro-bom</artifactId>
            <version>2.0.0</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.apache.shiro</groupId>
        <artifactId>shiro-spring-boot-web-starter</artifactId>
        <classifier>jakarta</classifier>
    </dependency>
    <!-- 其他Shiro依赖也需要添加jakarta分类器 -->
</dependencies>

技术要点

1. Jakarta EE迁移：Java EE从Oracle转移到Eclipse基金会后，所有javax包名都改为jakarta，这是导致兼容性问题的主要原因。

2. Shiro的适配策略：Shiro通过提供带有不同分类器的构建产物来同时支持javax和jakarta两种规范。

3. BOM的作用：Shiro BOM可以确保所有Shiro相关依赖使用一致的版本，避免版本冲突。

最佳实践建议

1. 对于新项目，建议直接使用Spring Boot 3.x + Shiro 2.x(jakarta)组合

2. 升级现有项目时，需要全面检查所有相关依赖是否都已适配Jakarta EE

3. 在IDE中，可以通过查看依赖树来确认是否正确加载了带有jakarta分类器的Shiro组件

4. 如果遇到类似类找不到的问题，首先检查是否所有相关依赖都使用了正确的分类器

通过以上配置和注意事项，开发者可以顺利地在Spring Boot 3.x环境中集成Apache Shiro 2.0.0，并避免javax与jakarta命名空间冲突导致的各种问题。