讲师中心 微信公众号
AI工具推荐 视频效率加速

@ConditionalOnClass怎样判断类路径

云枫君_5397

云枫君_5397

发布时间:2026-08-09 19:03:48

|

924人浏览过

|

来源于php中文网

原创

@ConditionalOnClass通过ClassLoader.loadClass()动态加载类来判断存在性,而非静态扫描;其在parse_configuration阶段触发,要求所有指定类均能成功加载才满足条件。

@conditionalonclass怎样判断类路径

要让 Spring Boot 在启动时准确判断某个类是否存在于类路径中,必须理解 @ConditionalOnClass 的真实工作方式——它不是扫描 jar 包或读取 class 文件,而是尝试用当前 ClassLoader 加载目标类。

@ConditionalOnClass 实际触发时机

Spring Boot 启动过程中,当 Configuration 类被解析时(即 parse_configuration 阶段),遇到 @ConditionalOnClass 注解,会立即调用其对应的 OnClassCondition.matches() 方法。

该方法内部执行 ClassUtils.isPresent(className, getClassLoader()),本质是调用 ClassLoader.loadClass(String name)。

只要不抛出 ClassNotFoundException 或 NoClassDefFoundError,就视为类存在;哪怕该类所在 jar 没有被依赖传递进来、或仅在 test scope 下,只要运行时 classpath 中能 load 到,条件即满足。

两种写法的加载行为差异

方法一:使用 Class 类型参数

@ConditionalOnClass(DataSource.class) → 编译期就能校验 DataSource 是否可访问,IDE 可提示、拼写错误会在编译时报出,推荐在项目内已有依赖时使用。

方法二:使用字符串类名参数

@ConditionalOnClass(name = "org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration") → 绕过编译期检查,适用于目标类尚未引入依赖(如可选模块)、或类名来自第三方未导出包的情况;但写错全限定名不会编译报错,只有启动时才失败。

【name 属性值必须是运行时实际存在的类全限定名,不能是接口、抽象类别名或不存在的别名】

多类判断的逻辑顺序

第一步:@ConditionalOnClass({JdbcTemplate.class, DataSource.class}) 要求两个类全部存在才通过。

第二步:Spring 会按数组顺序依次尝试加载每个类,一旦某个类加载失败(ClassNotFoundException),立刻中断并返回 false,后续类不再检查。

第三步:即使 JdbcTemplate 所在的 spring-jdbc.jar 已引入,但 DataSource 来自 spring-boot-autoconfigure,若该 jar 未出现在最终 classpath(例如 Maven 依赖被 exclude),整个条件仍不满足。

这一步没有缓存机制,每次 matches() 调用都重新执行 loadClass,所以类路径变动后重启应用才生效。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4356

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

306

2025.12.06

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4356

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

306

2025.12.06

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

0

2026.11.03

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

0

2026.11.03

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

20

2026.11.03

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn