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

@ConditionalOnMissingClass怎么排除

浅辰大大_7070

浅辰大大_7070

发布时间:2026-08-08 08:11:24

|

924人浏览过

|

来源于php中文网

原创

使用@ConditionalOnMissingClass需传入全限定类名字符串,排除间接依赖引入的目标类,再配合@ConditionalOnClass实现互斥配置。

@conditionalonmissingclass怎么排除

当Spring Boot项目中需要让某个自动配置类仅在特定类不存在时才生效,就必须正确使用@ConditionalOnMissingClass注解来排除干扰条件。

确认目标类是否真的未被加载

先检查目标类是否意外出现在classpath中——比如通过依赖传递引入了某SDK,其中包含你要排除的类。运行mvn dependency:tree -Dincludes=groupId:artifactId,定位该类来源。如果它来自间接依赖,【必须先排除该依赖,否则@ConditionalOnMissingClass永远不生效】。

在IDE里按Ctrl+点击类名跳转,若能成功打开源码或class文件,说明该类已存在,注解将直接跳过整个配置类。

正确写法:传入全限定类名字符串

方法一:直接写字符串

@ConditionalOnMissingClass("com.example.MyService")

注意不能写成@ConditionalOnMissingClass(MyService.class),因为该注解要求String数组,不是Class类型参数。写成class会编译报错。

方法二:多个类同时缺失才触发

@ConditionalOnMissingClass({"com.example.A", "com.example.B"})

只要其中任意一个类存在,整个条件即为false,配置类不会加载。

配合@ConditionalOnClass做互斥控制

第一步:定义主配置类,仅当MyClient不存在时启用备用实现

@Configuration
@ConditionalOnMissingClass("com.example.MyClient")
public class FallbackConfig { ... }

第二步:定义另一配置类,仅当MyClient存在时启用原生实现

@Configuration
@ConditionalOnClass(name = "com.example.MyClient")
public class NativeConfig { ... }

这两个类天然互斥——Spring Boot启动时只会加载其中一个。如果两个条件都满足(比如类存在但被ClassLoader隔离),以扫描顺序为准,但通常不会发生。

这一步操作起来很简单,直接把两个配置类放在同一包下即可,Spring Boot会自动识别并判断。

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞绘文

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的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