报错

com.xxx.encrypt.Encrypt是本地jar包，本地开发环境没有问题，测试环境运行jar包报上述错误
ClassNotFoundException异常
问题：com.xxx.encrypt.Encrypt类找不到。
原因分析：该类可能未被正确打包到应用程序中，或者类的包路径、类名存在拼写错误。

排查

“该类可能未被正确打包到应用程序中”，测试用Jenkins打包工具报错，本地打包在测试环境启动也报错，说明jar包一直没有打进去。
验证：
1.将包用解压工具打开，在目录 BOOT-INF/lib/xx 去找是否有报错信息中缺失的包，我这里验证是没有的

解决

1. 目录结构，使用若依框架
   ruoyi (根项目，POM类型)
   ├── ruoyi-admin (Web服务入口) pom配置打包信息
   ├── ruoyi-framework (框架核心)
   ├── ruoyi-system (系统模块)
   ├── ruoyi-common (通用工具) 此次问题jar包引入处
   ├── ruoyi-quartz (定时任务)
   └── ruoyi-generator (代码生成器)
2. maven项目，引入的本地依赖，在pom文件（ruoyi-common下）进行了配置，配置如下

<!-- 加解密工具 -->
<dependency>
  <groupId>xx</groupId>
  <artifactId>xx</artifactId>
  <version>xx</version>
  <scope>system</scope>
  <systemPath>${project.basedir}/lib/xx.jar</systemPath>
</dependency>

需要注意的是<scope>system</scope>标签，表示从本地引入

3. 检查打包pom配置中的<includeSystemScope>true</includeSystemScope>是否设置为true

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.5.15</version>
            <configuration>
                <fork>true</fork>
                <!--  检查是否为true  -->
                <includeSystemScope>true</includeSystemScope>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.1.0</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
                <warName>${project.artifactId}</warName>
            </configuration>
        </plugin>
    </plugins>
    <finalName>${project.artifactId}</finalName>
</build>

上述步骤检查，解决本地包没有打入包的问题

原因

1. 在 Maven 的 Spring Boot 插件配置中，<includeSystemScope>true</includeSystemScope> 的作用是：
   当项目中存在使用 <scope>system</scope> 声明的系统依赖（通常是本地文件系统中的 JAR 包）时，设置此属性为 true 会让 Spring Boot 打包插件在构建可执行 JAR/WAR 时，将这些系统依赖包含到最终的打包文件中。
2. 默认情况下，Maven 不会将 system 范围的依赖打包到构建产物中，因为这类依赖通常被认为是由系统环境提供的。而该配置强制将系统依赖包含进来，确保应用在运行时可以正常访问这些本地依赖，避免出现 ClassNotFoundException 等因缺少依赖导致的错误。