解决Spring Boot项目启动时出现的java.lang.NoClassDefFoundError：XXX的实用指南

问题分析

错误 java.lang.NoClassDefFoundError: com/touscm/tyt/user/domain/model/param/PageCompanyUserAccountInfoSqlParam 表示 JVM 在运行时尝试加载类 PageCompanyUserAccountInfoSqlParam，但未找到其定义。以下是可能的原因和解决方案：

原因 1：依赖未正确引入

该类可能属于某个依赖模块（如其他子模块、JAR 包或第三方库），但未正确引入到项目中。

解决方案：

检查 Maven/Gradle 依赖：
确认项目的 pom.xml 或 build.gradle 中已声明包含该类的依赖。
如果该类属于其他子模块，确保子模块已添加到父工程的 <modules> 中。

示例（Maven）：

<dependency>
    <groupId>com.xxx.tyt</groupId>
    <artifactId>user-domain</artifactId>
    <version>1.0.0</version>
</dependency>

检查依赖作用域：
确保依赖的 <scope> 不是 test 或 provided，否则编译时可见但运行时不可用。
重新下载依赖：
删除本地仓库中的依赖目录（如 Maven 的 ~/.m2/repository/com/touscm/tyt），重新执行 mvn clean install。

原因 2：类未编译或未打包

类文件未被正确编译或未包含在部署包（如 JAR/WAR）中。

解决方案：

检查编译输出目录：
确认 target/classes（Maven）或 build/classes（Gradle）下存在该类文件：
```
com/touscm/tyt/user/domain/model/param/PageCompanyUserAccountInfoSqlParam.class
```
检查构建配置：

在 Maven 中，确认 <build> 配置未排除该类的包路径：

<resources>
    <resource>
        <directory>src/main/java</directory>
        <includes>
            <include>**/*.java</include>
            <include>**/*.class</include>
        </includes>
    </resource>
</resources>

手动编译生成类：
执行 mvn clean compile 或 gradle build，观察编译日志是否有错误。

原因 3：动态生成的类未正确生成

如果该类是通过注解处理器（如 Lombok、MapStruct）生成的，可能因配置问题导致生成失败。

解决方案：

确认注解处理器已启用：
在 IDE（如 IntelliJ）中，确保启用注解处理：
Settings → Build → Compiler → Annotation Processors → Enable annotation processing.
检查 Lombok/MapStruct 配置：

确认依赖版本兼容，并已添加到构建文件中：

<!-- Lombok -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version>
    <scope>provided</scope>
</dependency>

清理并重新生成代码：
执行 mvn clean install 或删除 target/generated-sources 目录后重新构建。

原因 4：类路径（Classpath）问题

部署环境中类路径未包含该类的路径。

解决方案：

检查部署包内容：
解压 JAR/WAR 文件，确认是否包含 PageCompanyUserAccountInfoSqlParam.class：
```
jar tf your-application.jar | grep PageCompanyUserAccountInfoSqlParam
```
调整类路径配置：

在启动脚本中指定正确的类路径：

java -cp "lib/*:conf/" com.touscm.tyt.MainApplication

原因 5：依赖冲突

项目中存在多个版本的同一依赖，导致 JVM 加载了错误版本的类。

解决方案：

分析依赖树：

使用 Maven 命令检查依赖冲突：

mvn dependency:tree -Dincludes=com.touscm.tyt:user-domain

排除冲突依赖：

在 pom.xml 中排除旧版本：

<dependency>
    <groupId>com.other.library</groupId>
    <artifactId>conflicting-library</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.touscm.tyt</groupId>
            <artifactId>user-domain</artifactId>
        </exclusion>
    </exclusions>
</dependency>