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

SpringBoot自动配置和手动@Configuration有啥区别怎么选

夜磊大大_5491

夜磊大大_5491

发布时间:2026-08-08 17:02:38

|

231人浏览过

|

来源于php中文网

原创

必须用@AutoConfiguration开发Starter时实现零配置即用,需在META-INF/spring/...中声明并配合条件注解;自己项目中写配置类、需@ComponentScan扫描或覆盖默认配置时,必须用@Configuration。

springboot自动配置和手动@configuration有啥区别怎么选

Spring Boot项目里该用@Configuration还是@AutoConfiguration,直接决定Bean是否被自动扫描、是否参与条件判断、会不会和用户配置冲突——选错会导致Bean重复注册、条件失效或启动失败。

先看本质区别

普通@Configuration类是Spring原生机制,会被@ComponentScan扫到,走标准的Bean定义流程;而@AutoConfiguration是Spring Boot 2.7+专为自动配置设计的注解,它不参与组件扫描,只在@EnableAutoConfiguration触发时,由AutoConfigurationImportSelector按需加载,且默认隔离在自己的命名空间里。

你写的业务配置类,比如数据库连接池参数、自定义Service实现,必须用@Configuration;但如果你正在开发一个Starter,想让下游项目引入后自动装配RedisTemplate、自动绑定redis.host配置,那就必须用@AutoConfiguration。

什么时候必须用@AutoConfiguration

方法一:你要发布一个第三方Starter,且希望下游项目“零配置即用”

第一步:在Starter模块的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中,写入你的自动配置类全限定名,例如:com.example.redis.RedisAutoConfiguration

第二步:在该类上标注@AutoConfiguration,而不是@Configuration;否则Spring Boot启动时根本不会识别它——【@Configuration类不会被AutoConfigurationImportSelector加载】

第三步:配合@ConditionalOnClass(RedisTemplate.class)等条件注解,确保只在类路径存在Redis相关jar时才生效;@AutoConfiguration的条件评估时机比@Configuration早得多,能准确感知依赖是否存在。

这一步操作起来很简单,直接把文件拖进去就行。

什么时候坚决不能用@AutoConfiguration

方法一:你在自己项目的src/main/java下写配置类

直接写@AutoConfiguration会失效——因为Spring Boot只从Starter的META-INF/spring/...路径加载自动配置类,你本地代码里的类不会被AutoConfigurationImportSelector读取。

方法二:你需要通过@ComponentScan自动发现配置类

@AutoConfiguration类默认不被@ComponentScan扫描,即使加了@Component也不行;它必须显式注册进imports文件才能生效。如果你依赖包扫描来加载配置,必须用@Configuration。

方法三:你要覆盖Spring Boot默认配置

比如想用自己的DruidDataSource替代HikariCP,必须用@Configuration + @Bean + @Primary,再配合@ConditionalOnMissingBean;@AutoConfiguration不允许在用户工程里直接定义,否则会破坏自动配置的加载顺序和条件隔离。

怎么选:一张决策表

你正在开发的是Starter模块,且目标是让下游项目无感集成 → 用@AutoConfiguration。

你正在写自己项目的配置类,哪怕只是配一个RestTemplate Bean → 用@Configuration。

你想让某个配置类只在测试环境生效 → 用@Configuration + @Profile("test");@AutoConfiguration不支持Profile控制,它的条件体系是独立的。

你发现启动时报BeanDefinitionOverrideException,提示RedisTemplate已存在 → 检查是否误把@Configuration类放在了Starter里,又同时用了@AutoConfiguration导入同一类——这是典型冲突场景,删掉其中一个。

热门AI工具

更多
豆包大模型

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

WorkBuddy

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

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

UpDream
UpDream Hot

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

SkildArt
SkildArt Hot

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2211

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

417

2026.01.26

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

140

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

80

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

60

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

40

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

60

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

40

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

40

2026.09.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Redis6入门到精通超详细教程
Redis6入门到精通超详细教程

共47课时 | 7.1万人学习

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

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