@ConditionalOnClass(A.class)为什么不报错

问题说明

条件加载是springboot自动配置的刚需,其中有两个条件@ConditionalOnClass和@ConditionalOnMissingClass非常特别,它是基于class类是否存在判断的。场景的使用场景如下:

import A;
import B;

@Configuration
class C{
    @Bean
    @ConditionalOnClass(A.class)
    A getBeanA() {
        return new A();
    }
    @Bean
    @ConditionalOnMissingClass("A")
    B getBeanB() {
        return new B();
    }
}

在我们日常开发过程中,如果class A不存在,编译器会提示编译错误。在java运行过程中,当我们遇到class类不存在的时候会报ClassNotFoundException。上面的代码看起来无法成功初始化我们想要的类。但实际情况是spring通过这个机制正确的选择了具体的实现类,这是为什么呢?

JVM ClassLoader理论回顾

java代码的生命周期
在这里插入图片描述
类生命周期
在这里插入图片描述

何时开始类的初始化

Java虚拟机规范中并没有进行强制约束什么情况下需要开始类加载过程。但是对于初始化阶段,虚拟机规范则是严格规定了仅在类被“主动引用”时才会初始化。

主动引用
  • 创建类的实例
  • 访问类的静态变量(除常量【被final修辞的静态变量】)。
  • 访问类的静态方法
  • 反射如(Class.forName(“my.xyz.Test”))
  • 当初始化一个类时,发现其父类还未初始化,则先出发父类的初始化
  • 虚拟机启动时,定义了main()方法的那个类先初始化
被动引用
  • 子类调用父类的静态变量,子类不会被初始化。只有父类被初始化。对于静态字段,只有直接定义这个字段的类才会被初始化.
  • 通过数组定义来引用类,不会触发类的初始化
  • 访问类的常量,不会初始化类
关于java文件头的import

import的存在纯粹是为了方便写代码,在编译后的class文件中没有import区。在Java源码编译器进行编译时,每个名字都会经过解析(resolution)找到其全名(canonical form)。

ClassNotFoundException

当程序试图使用Class.forname()、Classloader#findSystemClass()、Classloader#loadClass()方法通过字符串名的形式加载此类时,会抛出ClassNotFoundException。

问题分析

从以上理论分析我们可以看出,我们在加载class C时,如果触发没有new A()就不会初始化class A,就不会有ClassNotFoundException。那问题又来了:如果class A不存在,springboot是如何选择执行getBeanA()方法还是getBeanB()方法呢?

springboot Bean加载机制和选择机制

springboot Bean加载分为Bean扫描注册和Bean初始化。

Bean扫描

springboot 通过ConfigurationClassBeanDefinitionReader读取@Configuration注解标识的类。在扫描候选资源时,spring并没有通过Classloader#loadClass()来加载class文件,而是通过Classloader.getResource()获得class二进制文件,通过ClassReader对二进制文件进行ASM语法解析,从而得到候选类和注解的元数据。也就是说在spring扫描需要加载的Bean时,所有候选类都没有加载初始化。
在这里插入图片描述

Bean加载判断

当spring获得候选bean的元信息时,需要判断这个bean是否真的需要被加载。这个就是spring的ConditionEvaluator体系。
比如在AnnotatedBeanDefinitionReader#doRegisterBean()中有判断:

AnnotatedGenericBeanDefinition abd = new AnnotatedGenericBeanDefinition(annotatedClass);
if (this.conditionEvaluator.shouldSkip(abd.getMetadata())) {
	return;
}

在这里插入图片描述
在获得ConditionalOnClass注解的元数据时还有个特殊处理,我们声明@ConditionalOnClass(A.class)时,使用的是Class类。为了后续操作时不引起class加载,AnnotatedElementUtils#getMergedAnnotationAttributes(element,annotationName,classValuesAsString,nestedAnnotationsAsMap)将class类转换成了class的名称字符串。
在最终判断class是否存在时,jvm其实还是抛出了ClassNotFoundException,只是异常被吞没了。(~ ̄▽ ̄)~

//OnClassCondition$MatchType.isPresent(String, ClassLoader) line: 219	

private static boolean isPresent(String className, ClassLoader classLoader) {
//省略若干行
	try {
		forName(className, classLoader);
		return true;
	}
	catch (Throwable ex) {
		return false;//我就在这里,只是你看不到    O(∩_∩)O
	}
}

所以关于这个问题的正确说法应该是,class类不存在时spring条件加载能够正常执行,而不是不报异常。
至此,当Class A不存在时,Bean B被注册到spring容器中,等待初始化。

Bean初始化

在初始化Bean时,AbstractAutowireCapableBeanFactory#createBeanInstance(String beanName, RootBeanDefinition mbd, @Nullable Object[] args)直接通过MethodProxy.invokeSuper()反射调用了C#getBeanB()。C#getBeanA()将永远不会被调用,默默地在角落里死去。。。

JVM类生命周期概述:加载时机与加载过程: https://blog.youkuaiyun.com/justloveyou_/article/details/72466105

<think>好的,我现在需要解决用户提到的Spring Boot项目启动时出现的IllegalStateException错误,具体是“Error processing condition on JacksonObjectMapper”。首先,我应该回忆一下Spring Boot中与Jackson相关的配置,以及可能导致条件处理失败的原因。 用户提供的引用信息中,引用[1]提到了Spring Boot的ErrorController,这可能与错误处理有关,但具体到Jackson的配置错误,可能需要更深入的分析。引用[2]展示了启动类的代码,这里看起来是标准的Spring Boot启动类,可能没有问题。引用[3]提到了一个Python的错误,可能与当前问题无关,但用户可能同时处理多个项目,过这里应专注于Java和Spring Boot的问题。 首先,IllegalStateException通常表示应用程序处于正确的状态,可能是在配置或初始化过程中出现了问题。错误信息中的“Error processing condition on JacksonObjectMapper”提示问题出在Jackson的自动配置条件处理上。可能的常见原因包括: 1. **依赖版本冲突**:同库之间的Jackson版本兼容,比如Spring Boot的版本与手动引入的Jackson版本一致。 2. **错误的配置属性**:在application.properties或application.yml中存在错误的Jackson配置,导致条件评估失败。 3. **自定义Jackson模块的问题**:如果项目中自定义了ObjectMapper或注册了Jackson模块,可能存在配置错误。 4. **条件注解使用当**:比如在自定义条件注解时存在逻辑错误,导致Spring无法正确处理。 接下来,我需要逐步引导用户排查这些可能的原因。首先检查依赖版本,确保所有Jackson相关的依赖(如jackson-databind、jackson-core、jackson-annotations)与Spring Boot版本兼容。用户可以通过Maven或Gradle的依赖树检查是否有冲突,使用`mvn dependency:tree`或`gradle dependencies`命令。 然后,检查配置文件中的Jackson相关属性,比如`spring.jackson.*`设置是否正确。例如,错误的日期格式或未识别的属性可能导致解析失败。用户应暂时注释掉这些配置,看问题是否解决。 如果项目中有自定义的ObjectMapper Bean,可能需要检查是否正确配置,尤其是使用`@Primary`注解时可能引起冲突。此外,检查是否有第三方库引入了过时的Jackson模块,这可能需要排除传递依赖。 最后,查看完整的堆栈跟踪,确定具体的错误位置。用户可能需要在启动时添加`--debug`参数来获取更详细的日志,或者检查异常的根本原因(通常由“Caused by”指出)。 可能还需要考虑Spring Boot自动配置的条件,比如类路径中存在某些类时触发的配置。如果某个条件无法满足,比如缺少必要的依赖,也可能导致错误。例如,如果引入了错误的Jackson模块版本,自动配置可能无法正确初始化ObjectMapper。 此外,用户应该确保没有重复定义Jackson的Bean,尤其是在多个配置类中定义了ObjectMapper,这可能导致冲突。Spring Boot默认会配置一个ObjectMapper,如果用户自定义了多个而没有正确标记主Bean,可能会引发问题。 总结解决方案步骤:检查依赖版本,排除冲突;检查配置文件中的Jackson设置;审查自定义Jackson配置;查看完整错误日志定位问题。这些步骤应该能帮助用户解决IllegalStateException。</think>### Spring Boot启动时IllegalStateException: Error processing condition on JacksonObjectMapper解决方案 #### 1. 检查依赖版本冲突 Spring Boot对Jackson的依赖有严格的版本要求,手动引入的Jackson库可能导致版本冲突。使用以下命令检查依赖树: ```bash # Maven项目 mvn dependency:tree | grep "jackson" # Gradle项目 gradle dependencies --configuration runtimeClasspath ``` 若发现多个同版本的Jackson组件(如jackson-databind、jackson-core),需统一版本。在pom.xml中显式指定版本: ```xml <properties> <jackson.version>2.15.2</jackson.version> </properties> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>${jackson.version}</version> </dependency> ``` #### 2. 验证自动配置条件 启动时添加`--debug`参数查看自动配置报告: ```bash java -jar your-application.jar --debug | grep "JacksonAutoConfiguration" ``` 若报告显示`@ConditionalOnClass`条件满足,说明类路径缺少必要依赖,例如: ```java // 检查是否缺少jackson-module-kotlin @ConditionalOnClass(com.fasterxml.jackson.module.kotlin.KotlinModule.class) ``` #### 3. 检查自定义Jackson配置 禁用所有自定义ObjectMapper配置以排查问题: ```java @SpringBootApplication(exclude = { JacksonAutoConfiguration.class }) public class MainApplication { public static void main(String[] args) { SpringApplication.run(MainApplication.class, args); } } ``` 若此时能正常启动,说明问题出在自定义配置中。检查以下典型错误配置: ```java // 错误示例:重复定义ObjectMapper @Bean public ObjectMapper objectMapper() { return new ObjectMapper(); // 与Spring Boot默认配置冲突 } // 正确做法:使用Jackson2ObjectMapperBuilderCustomizer @Bean public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() { return builder -> builder.simpleDateFormat("yyyy-MM-dd"); } ``` #### 4. 分析完整堆栈跟踪 在启动类中添加异常捕获点定位具体错误位置: ```java public static void main(String[] args) { try { SpringApplication.run(MainApplication.class, args); } catch (Exception ex) { ex.printStackTrace(); // 打印完整堆栈 System.exit(-1); } } ``` 典型错误可能包含类似信息: ``` Caused by: java.lang.NoSuchMethodError: com.fasterxml.jackson.databind.cfg.MapperBuilder.streamFactory()Lcom/fasterxml/json/StreamReadFeature; ``` 这表示存在版本兼容性问题[^2]。 #### 5. 验证配置属性 检查application.properties中Jackson相关配置: ```properties # 错误示例:使用无效属性 spring.jackson.date-format=ISO-8601 # 应该使用具体格式如yyyy-MM-dd # 正确配置示例 spring.jackson.time-zone=GMT+8 spring.jackson.deserialization.FAIL_ON_UNKNOWN_PROPERTIES=false ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值