使用 @controlleradvice 配合 @exceptionhandler 可以捕获类未找到异常。具体做法是定义一个全局异常处理类，在方法上标注 @exceptionhandler({classnotfoundexception.class, noclassdeffounderror.class})，并返回统一的错误响应结构。这样当应用加载缺失的类或依赖时，spring boot 会自动拦截异常并执行该逻辑。
如何区分 ClassNotFoundException 和 NoClassDefFoundError
这两个异常虽然都涉及类缺失，但触发时机不同。ClassNotFoundException 通常发生在反射调用（如 Class.forName()）时，而 NoClassDefFoundError 发生在类编译存在但运行时缺失时。在全局处理中，可以将它们放在同一个处理器中，或者分别处理以提供不同的提示。
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler({ClassNotFoundException.class, NoClassDefFoundError.class})
public ResponseEntity<string> handleMissingClass(Exception ex) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body("Missing class or dependency: " + ex.getMessage());
}
}</string>
如何处理因缺少特定依赖导致的启动失败
如果类未找到导致应用无法启动，全局异常处理器可能来不及生效。此时需要检查 application.properties 中的配置项，确保没有引用不存在的 Bean 或自动配置类。可以通过 @ConditionalOnClass 注解来优雅地处理可选依赖。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
@Configuration
public class OptionalConfig {
@Bean
@ConditionalOnClass(name = "com.example.MissingClass")
public String optionalBean() {
return "This bean is only created if MissingClass exists";
}
}
当自定义类路径下找不到类时如何排查
如果在自定义代码中动态加载类失败，应检查 ClassLoader 的路径设置。通过 Thread.currentThread().getContextClassLoader().getResources("") 可以查看当前类加载器扫描的路径，确认目标类所在的 JAR 包是否已正确引入到项目中。
