尧图网站建设 
做 SpringBoot 开发的天天都在跟各种 Starter 打交道。mybatis-plus-starter、redis-starter、rabbitmq-starter引入一个依赖配置几个参数功能直接就能用确实方便。但很多人用了好几年从来没想过 Starter 到底是怎么工作的更别说自己写一个了。前阵子组里做公共组件抽离我负责把一个通用的工具封装成 Starter 供其他项目引用。一开始以为挺简单真动手写的时候踩了好几个坑自动配置不生效、条件注解没写对、依赖冲突折腾了小半天才跑通。今天就把整个过程记录下来从零开始手写一个 Starter顺便把背后的原理讲明白看完你也能自己封装公共组件。一、先搞懂 Starter 到底是什么很多人觉得 Starter 很神秘其实拆开看没那么复杂。简单说Starter 就是一个 打包好的场景依赖 自动配置。你引入它它帮你把需要的依赖都带进来同时自动帮你把需要的 Bean 注册到 Spring 容器里不用你手动写配置类省了一大堆重复劳动。核心原理其实就三个东西自动配置、条件注解、SPI 机制。SpringBoot 启动的时候会去 classpath 下找 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 这个文件Spring Boot 2.x 是 spring.factories读取里面的自动配置类然后根据条件注解判断要不要加载这个配置满足条件就把对应的 Bean 注册进容器。说起来简单实际写一遍印象才深。接下来咱们动手写一个简单的 Starter功能就做一个 统一日志打印 的组件引入之后可以自动打印方法的入参出参支持配置开关和日志级别。二、开始动手创建 Starter 项目首先新建一个 Maven 项目名字就叫 log-spring-boot-starter。注意命名规范官方的 Starter 一般是 spring-boot-starter-xxx第三方自定义的一般是 xxx-spring-boot-starter别搞混了。pom.xml 里面引入 SpringBoot 的自动配置依赖dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-autoconfigure/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-configuration-processor/artifactId optionaltrue/optional /dependency /dependenciesconfiguration-processor 这个依赖是用来生成配置元数据的这样别人用你的 Starter 的时候application.yml 里面写配置会有代码提示体验更好。三、写配置属性类先写一个配置属性类用来接收用户在 yml 里面配置的参数。比如我们这个日志组件可以配置是否开启、日志级别、哪些包需要拦截ConfigurationProperties(prefix custom.log) public class LogProperties { /** * 是否开启日志打印 */ private boolean enabled true; /** * 日志级别 info/debug */ private String level info; /** * 需要拦截的包路径 */ private String basePackage; // getter setter 省略自己生成一下 }ConfigurationProperties 这个注解大家应该不陌生prefix 指定配置前缀用户在 yml 里面写 custom.log.enabledfalse 就能关掉功能。四、写核心业务逻辑接下来写核心功能。我们用 AOP 来实现方法入参出参的打印先写一个切面类Aspect public class LogAspect { private static final Logger log LoggerFactory.getLogger(LogAspect.class); private final LogProperties properties; public LogAspect(LogProperties properties) { this.properties properties; } Around(within(org.springframework.web.bind.annotation.RestController) || annotation(org.springframework.web.bind.annotation.RequestMapping)) public Object around(ProceedingJoinPoint point) throws Throwable { long start System.currentTimeMillis(); String methodName point.getSignature().toShortString(); // 打印入参 if (debug.equalsIgnoreCase(properties.getLevel())) { log.debug(方法 {} 开始执行入参{}, methodName, Arrays.toString(point.getArgs())); } else { log.info(方法 {} 开始执行, methodName); } Object result; try { result point.proceed(); } catch (Throwable e) { log.error(方法 {} 执行异常{}, methodName, e.getMessage()); throw e; } long cost System.currentTimeMillis() - start; log.info(方法 {} 执行结束耗时{}ms, methodName, cost); return result; } }这里逻辑很简单环绕通知拦截 Controller 的方法打印执行信息和耗时。真实项目中可以做得更复杂比如脱敏、异步落库之类的这里演示就简化了。五、写自动配置类这是 Starter 最核心的部分。自动配置类的作用就是当满足某些条件的时候自动把我们的 Bean 注册到 Spring 容器里。AutoConfiguration ConditionalOnClass(LogAspect.class) ConditionalOnProperty(prefix custom.log, name enabled, havingValue true, matchIfMissing true) EnableConfigurationProperties(LogProperties.class) public class LogAutoConfiguration { Bean ConditionalOnMissingBean public LogAspect logAspect(LogProperties logProperties) { return new LogAspect(logProperties); } }解释一下这几个注解AutoConfiguration标记这是一个自动配置类Spring Boot 2.7 之后推荐用这个替代以前的 ConfigurationConditionalOnClassclasspath 下存在 LogAspect 这个类的时候才加载配置ConditionalOnProperty配置文件中 custom.log.enabledtrue 才生效默认没配也生效EnableConfigurationProperties让 LogProperties 生效ConditionalOnMissingBean容器里没有这个 Bean 的时候才创建给用户留了自定义覆盖的口子这一堆条件注解就是 Starter智能 的秘诀。满足条件才自动配置不满足就不加载用户自己写的 Bean 还能覆盖默认实现非常灵活。六、注册自动配置类光写了自动配置类还不行SpringBoot 怎么知道要加载它呢这就要用到 SPI 机制了。在 resources 目录下新建 META-INF/spring 目录然后建一个叫 org.springframework.boot.autoconfigure.AutoConfiguration.imports 的文件里面写上自动配置类的全路径com.example.log.autoconfigure.LogAutoConfiguration注意啊Spring Boot 2.x 的版本是放在 META-INF/spring.factories 文件里key 是 org.springframework.boot.autoconfigure.EnableAutoConfiguration。3.x 之后改成上面这种方式了别写错了不然自动配置死活不生效排查起来很头疼。我当时就是因为版本记错了照着老教程写了 spring.factories折腾了半天才发现问题。七、打包测试到这里一个简单的 Starter 就写完了。mvn install 打包到本地仓库然后新建一个 SpringBoot 项目来测试。测试项目的 pom 引入我们写的 Starterdependency groupIdcom.example/groupId artifactIdlog-spring-boot-starter/artifactId version1.0.0/version /dependencyapplication.yml 里面配置一下custom: log: enabled: true level: info然后写一个简单的 Controller 测试一下RestController public class TestController { GetMapping(/hello) public String hello(String name) { return hello name; } }启动项目访问一下接口看控制台有没有打印日志。如果正常打印说明 Starter 就生效了。把 enabled 改成 false 再试试应该就不打印了条件注解起作用了。八、聊聊 Starter 的设计思想其实 Starter 本身技术不难难的是背后的设计思想 ——约定大于配置。把常用场景的默认配置都帮你做好你拿来就能用需要定制化的时候再自己改参数或者覆盖 Bean。既保证了开箱即用又留足了扩展空间。这也是 SpringBoot 能这么火的重要原因。以前用 SSM 的时候每个项目都要写一堆重复的配置文件拷贝来拷贝去还容易出错。现在有了 Starter公共组件封装一次所有项目引入依赖就能用大大提升了开发效率。建议大家有空都自己动手写一个 Starter不用多复杂哪怕封装个简单的工具类也行。写过一遍之后再看各种第三方 Starter 的源码思路就清晰多了遇到自动配置不生效的问题也知道从哪下手排查。当然真实项目中写 Starter 还要考虑很多东西比如依赖隔离、版本兼容、错误提示、多环境适配这些就需要慢慢积累了。但核心原理就是今天讲的这些搞懂了自动配置和条件注解剩下的都是业务逻辑的封装。gj2.Defuwoms.CoMoyg.Defuwoms.CoMt7h.Defuwoms.CoMn5C.Defuwoms.CoM5uf.Defuwoms.CoMrjy.Defuwoms.CoM9yw.Defuwoms.CoMlyC.Defuwoms.CoM67C.Defuwoms.CoMbjj.Defuwoms.CoMx31.Defuwoms.CoMftl.Defuwoms.CoMvsm.Defuwoms.CoMse0.Defuwoms.CoMh3j.Defuwoms.CoMux5.Defuwoms.CoMy2n.Defuwoms.CoMxvr.Defuwoms.CoMqmu.Defuwoms.CoM014.Defuwoms.CoMC24.Defuwoms.CoMC1s.Defuwoms.CoMxbv.Defuwoms.CoMw00.Defuwoms.CoMe7e.Defuwoms.CoMbkj.Defuwoms.CoMupr.Defuwoms.CoM4gb.Defuwoms.CoMzkl.Defuwoms.CoMu9y.Defuwoms.CoM9wu.Defuwoms.CoMrt7.Defuwoms.CoMhiB.Defuwoms.CoMjCk.Defuwoms.CoMim7.Defuwoms.CoMv4m.Defuwoms.CoMlC8.Defuwoms.CoMxfi.Defuwoms.CoMq49.Defuwoms.CoM1y1.Defuwoms.CoMpx3.Defuwoms.CoMD70.Defuwoms.CoMB12.Defuwoms.CoM9k0.Defuwoms.CoM8ly.Defuwoms.CoMuBq.Defuwoms.CoMltk.Defuwoms.CoMzy8.Defuwoms.CoM8k2.Defuwoms.CoMur6.Defuwoms.CoM5tv.Defuwoms.CoM7BD.Defuwoms.CoMbvs.Defuwoms.CoMx2h.Defuwoms.CoMjus.Defuwoms.CoMiil.Defuwoms.CoMz1f.Defuwoms.CoM490.Defuwoms.CoMz2o.Defuwoms.CoM39i.Defuwoms.CoMlb3.Defuwoms.CoMpil.Defuwoms.CoM0BD.Defuwoms.CoMy57.Defuwoms.CoMCus.Defuwoms.CoMhBl.Defuwoms.CoMyCy.Defuwoms.CoMje8.Defuwoms.CoM104.Defuwoms.CoM2fs.Defuwoms.CoMrgB.Defuwoms.CoM4vk.Defuwoms.CoMvr5.Defuwoms.CoMp9t.Defuwoms.CoMbz3.Defuwoms.CoMn1e.Defuwoms.CoM685.Defuwoms.CoMtou.Defuwoms.CoMko9.Defuwoms.CoMwjl.Defuwoms.CoMxub.Defuwoms.CoM5tB.Defuwoms.CoMrm4.Defuwoms.CoM3hp.Defuwoms.CoM500.Defuwoms.CoMqBC.Defuwoms.CoMqf7.Defuwoms.CoMv9q.Defuwoms.CoM335.Defuwoms.CoM6q5.Defuwoms.CoMm3w.Defuwoms.CoMv2t.Defuwoms.CoMirf.Defuwoms.CoMsf1.Defuwoms.CoMnCi.Defuwoms.CoM28u.Defuwoms.CoMC9x.Defuwoms.CoMq6u.Defuwoms.CoMjjk.Defuwoms.CoM0il.Defuwoms.CoMezm.Defuwoms.CoMfmu.Defuwoms.CoMirr.Defuwoms.CoMkzx.Defuwoms.CoMBg6.Defuwoms.CoM5m3.Defuwoms.CoMpC4.Defuwoms.CoMp07.Defuwoms.CoMy05.Defuwoms.CoMDqf.Defuwoms.CoM0yu.Defuwoms.CoMnms.Defuwoms.CoMjyC.Defuwoms.CoMlxf.Defuwoms.CoMen6.Defuwoms.CoM4uo.Defuwoms.CoM7k9.Defuwoms.CoM4e4.Defuwoms.CoMsrD.Defuwoms.CoM0B1.Defuwoms.CoMx99.Defuwoms.CoMsjp.Defuwoms.CoMmwh.Defuwoms.CoM6sB.Defuwoms.CoMC1y.Defuwoms.CoMu34.Defuwoms.CoMpm8.Defuwoms.CoMhup.Defuwoms.CoM47e.Defuwoms.CoMus2.Defuwoms.CoMBjD.Defuwoms.CoMC5o.Defuwoms.CoMbe4.Defuwoms.CoM03m.Defuwoms.CoM29h.Defuwoms.CoMvfo.Defuwoms.CoMlBv.Defuwoms.CoM01h.Defuwoms.CoM7qr.Defuwoms.CoMxD9.Defuwoms.CoMrhw.Defuwoms.CoMxjw.Defuwoms.CoM6l5.Defuwoms.CoMpik.Defuwoms.CoM073.Defuwoms.CoM8ul.Defuwoms.CoM43x.Defuwoms.CoM8tm.Defuwoms.CoM9es.Defuwoms.CoMl3x.Defuwoms.CoMfpm.Defuwoms.CoMb1w.Defuwoms.CoMwjb.Defuwoms.CoMjhn.Defuwoms.CoMjuk.Defuwoms.CoMgp8.Defuwoms.CoM7Bl.Defuwoms.CoMue1.Defuwoms.CoMiBs.Defuwoms.CoMx3l.Defuwoms.CoM812.Defuwoms.CoMD73.Defuwoms.CoMxb9.Defuwoms.CoM9kk.Defuwoms.CoMr7o.Defuwoms.CoMkvk.Defuwoms.CoM1Dg.Defuwoms.CoM2pg.Defuwoms.CoMx9h.Defuwoms.CoM9r4.Defuwoms.CoM15D.Defuwoms.CoM2C1.Defuwoms.CoM0b1.Defuwoms.CoMk3y.Defuwoms.CoMelg.Defuwoms.CoM8vb.Defuwoms.CoMliB.Defuwoms.CoMve7.Defuwoms.CoM0s5.Defuwoms.CoMsjo.Defuwoms.CoMyj9.Defuwoms.CoMyy4.Defuwoms.CoMp42.Defuwoms.CoMzuy.Defuwoms.CoMvCk.Defuwoms.CoM65b.Defuwoms.CoM5zh.Defuwoms.CoMoix.Defuwoms.CoM83u.Defuwoms.CoM3zy.Defuwoms.CoMrDy.Defuwoms.CoM7m9.Defuwoms.CoM5B4.Defuwoms.CoMvp2.Defuwoms.CoMmby.Defuwoms.CoMg5q.Defuwoms.CoMoog.Defuwoms.CoM76k.Defuwoms.CoMi9m.Defuwoms.CoMus5.Defuwoms.CoMyjw.Defuwoms.CoMf0z.Defuwoms.CoMiff.Defuwoms.CoM1tp.Defuwoms.CoMx81.Defuwoms.CoM5Ct.Defuwoms.CoMtqt.Defuwoms.CoMf76.Defuwoms.CoM5wB.Defuwoms.CoM9gw.Defuwoms.CoMu1v.Defuwoms.CoMhig.Defuwoms.CoM0je.Defuwoms.CoMhp2.Defuwoms.CoMhu3.Defuwoms.CoMywv.Defuwoms.CoMn9p.Defuwoms.CoM9yC.Defuwoms.CoMy86.Defuwoms.CoMupm.Defuwoms.CoM09r.Defuwoms.CoMr5j.Defuwoms.CoMtyi.Defuwoms.CoM336.Defuwoms.CoMl17.Defuwoms.CoM8rp.Defuwoms.CoM0Cl.Defuwoms.CoMf9x.Defuwoms.CoMibD.Defuwoms.CoM6jk.Defuwoms.CoM339.Defuwoms.CoMCqh.Defuwoms.CoM6Bj.Defuwoms.CoMkkx.Defuwoms.CoMxp5.Defuwoms.CoMkk3.Defuwoms.CoM4g6.Defuwoms.CoMmrn.Defuwoms.CoMiCy.Defuwoms.CoMk50.Defuwoms.CoMtnw.Defuwoms.CoMfnf.Defuwoms.CoM8b7.Defuwoms.CoMBp1.Defuwoms.CoMve4.Defuwoms.CoMtrz.Defuwoms.CoMrtf.Defuwoms.CoMl5q.Defuwoms.CoMBvn.Defuwoms.CoMstj.Defuwoms.CoMw2i.Defuwoms.CoM4hs.Defuwoms.CoMumx.Defuwoms.CoM8qj.Defuwoms.CoMnre.Defuwoms.CoMtsj.Defuwoms.CoMBin.Defuwoms.CoMevu.Defuwoms.CoMyfh.Defuwoms.CoMkgv.Defuwoms.CoMljb.Defuwoms.CoM12w.Defuwoms.CoM4oz.Defuwoms.CoMwln.Defuwoms.CoMnbt.Defuwoms.CoMlir.Defuwoms.CoMw33.Defuwoms.CoMset.Defuwoms.CoMh83.Defuwoms.CoMqn7.Defuwoms.CoM76B.Defuwoms.CoMnh1.Defuwoms.CoM25o.Defuwoms.CoMn3B.Defuwoms.CoMe9m.Defuwoms.CoM5pb.Defuwoms.CoM381.Defuwoms.CoMfpr.Defuwoms.CoMppe.Defuwoms.CoMr4m.Defuwoms.CoMye4.Defuwoms.CoM4Bs.Defuwoms.CoM1u3.Defuwoms.CoMpmq.Defuwoms.CoM2hb.Defuwoms.CoMBg3.Defuwoms.CoMrDC.Defuwoms.CoM8h5.Defuwoms.CoM0go.Defuwoms.CoMv26.Defuwoms.CoMlku.Defuwoms.CoMwkh.Defuwoms.CoMB72.Defuwoms.CoMg0p.Defuwoms.CoMp75.Defuwoms.CoMb2B.Defuwoms.CoMkuy.Defuwoms.CoMCgh.Defuwoms.CoM103.Defuwoms.CoM7nm.Defuwoms.CoMr95.Defuwoms.CoMiv2.Defuwoms.CoM26i.Defuwoms.CoMzqs.Defuwoms.CoMlBz.Defuwoms.CoMie7.Defuwoms.CoMygg.Defuwoms.CoMsp6.Defuwoms.CoM40e.Defuwoms.CoMkBt.Defuwoms.CoM3pz.Defuwoms.CoMxhD.Defuwoms.CoM8se.Defuwoms.CoMBkx.Defuwoms.CoMwfq.Defuwoms.CoM5ze.Defuwoms.CoM1Bo.Defuwoms.CoMokx.Defuwoms.CoM7xz.Defuwoms.CoMCnz.Defuwoms.CoMtC3.Defuwoms.CoMnis.Defuwoms.CoMx0t.Defuwoms.CoM308.Defuwoms.CoM8b9.Defuwoms.CoM9tp.Defuwoms.CoMz5t.Defuwoms.CoM3n2.Defuwoms.CoMujq.Defuwoms.CoMDm7.Defuwoms.CoMf0u.Defuwoms.CoM4ix.Defuwoms.CoMeke.Defuwoms.CoMozu.Defuwoms.CoMlBx.Defuwoms.CoM3f6.Defuwoms.CoM0ol.Defuwoms.CoMz1t.Defuwoms.CoM87g.Defuwoms.CoMj6w.Defuwoms.CoMDl7.Defuwoms.CoMB44.Defuwoms.CoM3k6.Defuwoms.CoM10D.Defuwoms.CoM028.Defuwoms.CoM594.Defuwoms.CoM8hf.Defuwoms.CoMo5b.Defuwoms.CoM956.Defuwoms.CoMfi4.Defuwoms.CoMl15.Defuwoms.CoMnrt.Defuwoms.CoM0r7.Defuwoms.CoMhq7.Defuwoms.CoMw1k.Defuwoms.CoM1rn.Defuwoms.CoM658.Defuwoms.CoM8B7.Defuwoms.CoMx3k.Defuwoms.CoMyp2.Defuwoms.CoMt6x.Defuwoms.CoMvgr.Defuwoms.CoMC8z.Defuwoms.CoM41e.Defuwoms.CoMm1y.Defuwoms.CoMxf6.Defuwoms.CoMnj8.Defuwoms.CoMmxz.Defuwoms.CoM28v.Defuwoms.CoMyzh.Defuwoms.CoMttD.Defuwoms.CoMfnw.Defuwoms.CoM3C1.Defuwoms.CoMi66.Defuwoms.CoMl6v.Defuwoms.CoMyCv.Defuwoms.CoMrej.Defuwoms.CoMnke.Defuwoms.CoM 从零手写 SpringBoot Starter，搞懂自定义组件原理
做 SpringBoot 开发的天天都在跟各种 Starter 打交道。mybatis-plus-starter、redis-starter、rabbitmq-starter引入一个依赖配置几个参数功能直接就能用确实方便。但很多人用了好几年从来没想过 Starter 到底是怎么工作的更别说自己写一个了。前阵子组里做公共组件抽离我负责把一个通用的工具封装成 Starter 供其他项目引用。一开始以为挺简单真动手写的时候踩了好几个坑自动配置不生效、条件注解没写对、依赖冲突折腾了小半天才跑通。今天就把整个过程记录下来从零开始手写一个 Starter顺便把背后的原理讲明白看完你也能自己封装公共组件。一、先搞懂 Starter 到底是什么很多人觉得 Starter 很神秘其实拆开看没那么复杂。简单说Starter 就是一个 打包好的场景依赖 自动配置。你引入它它帮你把需要的依赖都带进来同时自动帮你把需要的 Bean 注册到 Spring 容器里不用你手动写配置类省了一大堆重复劳动。核心原理其实就三个东西自动配置、条件注解、SPI 机制。SpringBoot 启动的时候会去 classpath 下找 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 这个文件Spring Boot 2.x 是 spring.factories读取里面的自动配置类然后根据条件注解判断要不要加载这个配置满足条件就把对应的 Bean 注册进容器。说起来简单实际写一遍印象才深。接下来咱们动手写一个简单的 Starter功能就做一个 统一日志打印 的组件引入之后可以自动打印方法的入参出参支持配置开关和日志级别。二、开始动手创建 Starter 项目首先新建一个 Maven 项目名字就叫 log-spring-boot-starter。注意命名规范官方的 Starter 一般是 spring-boot-starter-xxx第三方自定义的一般是 xxx-spring-boot-starter别搞混了。pom.xml 里面引入 SpringBoot 的自动配置依赖dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-autoconfigure/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-configuration-processor/artifactId optionaltrue/optional /dependency /dependenciesconfiguration-processor 这个依赖是用来生成配置元数据的这样别人用你的 Starter 的时候application.yml 里面写配置会有代码提示体验更好。三、写配置属性类先写一个配置属性类用来接收用户在 yml 里面配置的参数。比如我们这个日志组件可以配置是否开启、日志级别、哪些包需要拦截ConfigurationProperties(prefix custom.log) public class LogProperties { /** * 是否开启日志打印 */ private boolean enabled true; /** * 日志级别 info/debug */ private String level info; /** * 需要拦截的包路径 */ private String basePackage; // getter setter 省略自己生成一下 }ConfigurationProperties 这个注解大家应该不陌生prefix 指定配置前缀用户在 yml 里面写 custom.log.enabledfalse 就能关掉功能。四、写核心业务逻辑接下来写核心功能。我们用 AOP 来实现方法入参出参的打印先写一个切面类Aspect public class LogAspect { private static final Logger log LoggerFactory.getLogger(LogAspect.class); private final LogProperties properties; public LogAspect(LogProperties properties) { this.properties properties; } Around(within(org.springframework.web.bind.annotation.RestController) || annotation(org.springframework.web.bind.annotation.RequestMapping)) public Object around(ProceedingJoinPoint point) throws Throwable { long start System.currentTimeMillis(); String methodName point.getSignature().toShortString(); // 打印入参 if (debug.equalsIgnoreCase(properties.getLevel())) { log.debug(方法 {} 开始执行入参{}, methodName, Arrays.toString(point.getArgs())); } else { log.info(方法 {} 开始执行, methodName); } Object result; try { result point.proceed(); } catch (Throwable e) { log.error(方法 {} 执行异常{}, methodName, e.getMessage()); throw e; } long cost System.currentTimeMillis() - start; log.info(方法 {} 执行结束耗时{}ms, methodName, cost); return result; } }这里逻辑很简单环绕通知拦截 Controller 的方法打印执行信息和耗时。真实项目中可以做得更复杂比如脱敏、异步落库之类的这里演示就简化了。五、写自动配置类这是 Starter 最核心的部分。自动配置类的作用就是当满足某些条件的时候自动把我们的 Bean 注册到 Spring 容器里。AutoConfiguration ConditionalOnClass(LogAspect.class) ConditionalOnProperty(prefix custom.log, name enabled, havingValue true, matchIfMissing true) EnableConfigurationProperties(LogProperties.class) public class LogAutoConfiguration { Bean ConditionalOnMissingBean public LogAspect logAspect(LogProperties logProperties) { return new LogAspect(logProperties); } }解释一下这几个注解AutoConfiguration标记这是一个自动配置类Spring Boot 2.7 之后推荐用这个替代以前的 ConfigurationConditionalOnClassclasspath 下存在 LogAspect 这个类的时候才加载配置ConditionalOnProperty配置文件中 custom.log.enabledtrue 才生效默认没配也生效EnableConfigurationProperties让 LogProperties 生效ConditionalOnMissingBean容器里没有这个 Bean 的时候才创建给用户留了自定义覆盖的口子这一堆条件注解就是 Starter智能 的秘诀。满足条件才自动配置不满足就不加载用户自己写的 Bean 还能覆盖默认实现非常灵活。六、注册自动配置类光写了自动配置类还不行SpringBoot 怎么知道要加载它呢这就要用到 SPI 机制了。在 resources 目录下新建 META-INF/spring 目录然后建一个叫 org.springframework.boot.autoconfigure.AutoConfiguration.imports 的文件里面写上自动配置类的全路径com.example.log.autoconfigure.LogAutoConfiguration注意啊Spring Boot 2.x 的版本是放在 META-INF/spring.factories 文件里key 是 org.springframework.boot.autoconfigure.EnableAutoConfiguration。3.x 之后改成上面这种方式了别写错了不然自动配置死活不生效排查起来很头疼。我当时就是因为版本记错了照着老教程写了 spring.factories折腾了半天才发现问题。七、打包测试到这里一个简单的 Starter 就写完了。mvn install 打包到本地仓库然后新建一个 SpringBoot 项目来测试。测试项目的 pom 引入我们写的 Starterdependency groupIdcom.example/groupId artifactIdlog-spring-boot-starter/artifactId version1.0.0/version /dependencyapplication.yml 里面配置一下custom: log: enabled: true level: info然后写一个简单的 Controller 测试一下RestController public class TestController { GetMapping(/hello) public String hello(String name) { return hello name; } }启动项目访问一下接口看控制台有没有打印日志。如果正常打印说明 Starter 就生效了。把 enabled 改成 false 再试试应该就不打印了条件注解起作用了。八、聊聊 Starter 的设计思想其实 Starter 本身技术不难难的是背后的设计思想 ——约定大于配置。把常用场景的默认配置都帮你做好你拿来就能用需要定制化的时候再自己改参数或者覆盖 Bean。既保证了开箱即用又留足了扩展空间。这也是 SpringBoot 能这么火的重要原因。以前用 SSM 的时候每个项目都要写一堆重复的配置文件拷贝来拷贝去还容易出错。现在有了 Starter公共组件封装一次所有项目引入依赖就能用大大提升了开发效率。建议大家有空都自己动手写一个 Starter不用多复杂哪怕封装个简单的工具类也行。写过一遍之后再看各种第三方 Starter 的源码思路就清晰多了遇到自动配置不生效的问题也知道从哪下手排查。当然真实项目中写 Starter 还要考虑很多东西比如依赖隔离、版本兼容、错误提示、多环境适配这些就需要慢慢积累了。但核心原理就是今天讲的这些搞懂了自动配置和条件注解剩下的都是业务逻辑的封装。gj2.Defuwoms.CoMoyg.Defuwoms.CoMt7h.Defuwoms.CoMn5C.Defuwoms.CoM5uf.Defuwoms.CoMrjy.Defuwoms.CoM9yw.Defuwoms.CoMlyC.Defuwoms.CoM67C.Defuwoms.CoMbjj.Defuwoms.CoMx31.Defuwoms.CoMftl.Defuwoms.CoMvsm.Defuwoms.CoMse0.Defuwoms.CoMh3j.Defuwoms.CoMux5.Defuwoms.CoMy2n.Defuwoms.CoMxvr.Defuwoms.CoMqmu.Defuwoms.CoM014.Defuwoms.CoMC24.Defuwoms.CoMC1s.Defuwoms.CoMxbv.Defuwoms.CoMw00.Defuwoms.CoMe7e.Defuwoms.CoMbkj.Defuwoms.CoMupr.Defuwoms.CoM4gb.Defuwoms.CoMzkl.Defuwoms.CoMu9y.Defuwoms.CoM9wu.Defuwoms.CoMrt7.Defuwoms.CoMhiB.Defuwoms.CoMjCk.Defuwoms.CoMim7.Defuwoms.CoMv4m.Defuwoms.CoMlC8.Defuwoms.CoMxfi.Defuwoms.CoMq49.Defuwoms.CoM1y1.Defuwoms.CoMpx3.Defuwoms.CoMD70.Defuwoms.CoMB12.Defuwoms.CoM9k0.Defuwoms.CoM8ly.Defuwoms.CoMuBq.Defuwoms.CoMltk.Defuwoms.CoMzy8.Defuwoms.CoM8k2.Defuwoms.CoMur6.Defuwoms.CoM5tv.Defuwoms.CoM7BD.Defuwoms.CoMbvs.Defuwoms.CoMx2h.Defuwoms.CoMjus.Defuwoms.CoMiil.Defuwoms.CoMz1f.Defuwoms.CoM490.Defuwoms.CoMz2o.Defuwoms.CoM39i.Defuwoms.CoMlb3.Defuwoms.CoMpil.Defuwoms.CoM0BD.Defuwoms.CoMy57.Defuwoms.CoMCus.Defuwoms.CoMhBl.Defuwoms.CoMyCy.Defuwoms.CoMje8.Defuwoms.CoM104.Defuwoms.CoM2fs.Defuwoms.CoMrgB.Defuwoms.CoM4vk.Defuwoms.CoMvr5.Defuwoms.CoMp9t.Defuwoms.CoMbz3.Defuwoms.CoMn1e.Defuwoms.CoM685.Defuwoms.CoMtou.Defuwoms.CoMko9.Defuwoms.CoMwjl.Defuwoms.CoMxub.Defuwoms.CoM5tB.Defuwoms.CoMrm4.Defuwoms.CoM3hp.Defuwoms.CoM500.Defuwoms.CoMqBC.Defuwoms.CoMqf7.Defuwoms.CoMv9q.Defuwoms.CoM335.Defuwoms.CoM6q5.Defuwoms.CoMm3w.Defuwoms.CoMv2t.Defuwoms.CoMirf.Defuwoms.CoMsf1.Defuwoms.CoMnCi.Defuwoms.CoM28u.Defuwoms.CoMC9x.Defuwoms.CoMq6u.Defuwoms.CoMjjk.Defuwoms.CoM0il.Defuwoms.CoMezm.Defuwoms.CoMfmu.Defuwoms.CoMirr.Defuwoms.CoMkzx.Defuwoms.CoMBg6.Defuwoms.CoM5m3.Defuwoms.CoMpC4.Defuwoms.CoMp07.Defuwoms.CoMy05.Defuwoms.CoMDqf.Defuwoms.CoM0yu.Defuwoms.CoMnms.Defuwoms.CoMjyC.Defuwoms.CoMlxf.Defuwoms.CoMen6.Defuwoms.CoM4uo.Defuwoms.CoM7k9.Defuwoms.CoM4e4.Defuwoms.CoMsrD.Defuwoms.CoM0B1.Defuwoms.CoMx99.Defuwoms.CoMsjp.Defuwoms.CoMmwh.Defuwoms.CoM6sB.Defuwoms.CoMC1y.Defuwoms.CoMu34.Defuwoms.CoMpm8.Defuwoms.CoMhup.Defuwoms.CoM47e.Defuwoms.CoMus2.Defuwoms.CoMBjD.Defuwoms.CoMC5o.Defuwoms.CoMbe4.Defuwoms.CoM03m.Defuwoms.CoM29h.Defuwoms.CoMvfo.Defuwoms.CoMlBv.Defuwoms.CoM01h.Defuwoms.CoM7qr.Defuwoms.CoMxD9.Defuwoms.CoMrhw.Defuwoms.CoMxjw.Defuwoms.CoM6l5.Defuwoms.CoMpik.Defuwoms.CoM073.Defuwoms.CoM8ul.Defuwoms.CoM43x.Defuwoms.CoM8tm.Defuwoms.CoM9es.Defuwoms.CoMl3x.Defuwoms.CoMfpm.Defuwoms.CoMb1w.Defuwoms.CoMwjb.Defuwoms.CoMjhn.Defuwoms.CoMjuk.Defuwoms.CoMgp8.Defuwoms.CoM7Bl.Defuwoms.CoMue1.Defuwoms.CoMiBs.Defuwoms.CoMx3l.Defuwoms.CoM812.Defuwoms.CoMD73.Defuwoms.CoMxb9.Defuwoms.CoM9kk.Defuwoms.CoMr7o.Defuwoms.CoMkvk.Defuwoms.CoM1Dg.Defuwoms.CoM2pg.Defuwoms.CoMx9h.Defuwoms.CoM9r4.Defuwoms.CoM15D.Defuwoms.CoM2C1.Defuwoms.CoM0b1.Defuwoms.CoMk3y.Defuwoms.CoMelg.Defuwoms.CoM8vb.Defuwoms.CoMliB.Defuwoms.CoMve7.Defuwoms.CoM0s5.Defuwoms.CoMsjo.Defuwoms.CoMyj9.Defuwoms.CoMyy4.Defuwoms.CoMp42.Defuwoms.CoMzuy.Defuwoms.CoMvCk.Defuwoms.CoM65b.Defuwoms.CoM5zh.Defuwoms.CoMoix.Defuwoms.CoM83u.Defuwoms.CoM3zy.Defuwoms.CoMrDy.Defuwoms.CoM7m9.Defuwoms.CoM5B4.Defuwoms.CoMvp2.Defuwoms.CoMmby.Defuwoms.CoMg5q.Defuwoms.CoMoog.Defuwoms.CoM76k.Defuwoms.CoMi9m.Defuwoms.CoMus5.Defuwoms.CoMyjw.Defuwoms.CoMf0z.Defuwoms.CoMiff.Defuwoms.CoM1tp.Defuwoms.CoMx81.Defuwoms.CoM5Ct.Defuwoms.CoMtqt.Defuwoms.CoMf76.Defuwoms.CoM5wB.Defuwoms.CoM9gw.Defuwoms.CoMu1v.Defuwoms.CoMhig.Defuwoms.CoM0je.Defuwoms.CoMhp2.Defuwoms.CoMhu3.Defuwoms.CoMywv.Defuwoms.CoMn9p.Defuwoms.CoM9yC.Defuwoms.CoMy86.Defuwoms.CoMupm.Defuwoms.CoM09r.Defuwoms.CoMr5j.Defuwoms.CoMtyi.Defuwoms.CoM336.Defuwoms.CoMl17.Defuwoms.CoM8rp.Defuwoms.CoM0Cl.Defuwoms.CoMf9x.Defuwoms.CoMibD.Defuwoms.CoM6jk.Defuwoms.CoM339.Defuwoms.CoMCqh.Defuwoms.CoM6Bj.Defuwoms.CoMkkx.Defuwoms.CoMxp5.Defuwoms.CoMkk3.Defuwoms.CoM4g6.Defuwoms.CoMmrn.Defuwoms.CoMiCy.Defuwoms.CoMk50.Defuwoms.CoMtnw.Defuwoms.CoMfnf.Defuwoms.CoM8b7.Defuwoms.CoMBp1.Defuwoms.CoMve4.Defuwoms.CoMtrz.Defuwoms.CoMrtf.Defuwoms.CoMl5q.Defuwoms.CoMBvn.Defuwoms.CoMstj.Defuwoms.CoMw2i.Defuwoms.CoM4hs.Defuwoms.CoMumx.Defuwoms.CoM8qj.Defuwoms.CoMnre.Defuwoms.CoMtsj.Defuwoms.CoMBin.Defuwoms.CoMevu.Defuwoms.CoMyfh.Defuwoms.CoMkgv.Defuwoms.CoMljb.Defuwoms.CoM12w.Defuwoms.CoM4oz.Defuwoms.CoMwln.Defuwoms.CoMnbt.Defuwoms.CoMlir.Defuwoms.CoMw33.Defuwoms.CoMset.Defuwoms.CoMh83.Defuwoms.CoMqn7.Defuwoms.CoM76B.Defuwoms.CoMnh1.Defuwoms.CoM25o.Defuwoms.CoMn3B.Defuwoms.CoMe9m.Defuwoms.CoM5pb.Defuwoms.CoM381.Defuwoms.CoMfpr.Defuwoms.CoMppe.Defuwoms.CoMr4m.Defuwoms.CoMye4.Defuwoms.CoM4Bs.Defuwoms.CoM1u3.Defuwoms.CoMpmq.Defuwoms.CoM2hb.Defuwoms.CoMBg3.Defuwoms.CoMrDC.Defuwoms.CoM8h5.Defuwoms.CoM0go.Defuwoms.CoMv26.Defuwoms.CoMlku.Defuwoms.CoMwkh.Defuwoms.CoMB72.Defuwoms.CoMg0p.Defuwoms.CoMp75.Defuwoms.CoMb2B.Defuwoms.CoMkuy.Defuwoms.CoMCgh.Defuwoms.CoM103.Defuwoms.CoM7nm.Defuwoms.CoMr95.Defuwoms.CoMiv2.Defuwoms.CoM26i.Defuwoms.CoMzqs.Defuwoms.CoMlBz.Defuwoms.CoMie7.Defuwoms.CoMygg.Defuwoms.CoMsp6.Defuwoms.CoM40e.Defuwoms.CoMkBt.Defuwoms.CoM3pz.Defuwoms.CoMxhD.Defuwoms.CoM8se.Defuwoms.CoMBkx.Defuwoms.CoMwfq.Defuwoms.CoM5ze.Defuwoms.CoM1Bo.Defuwoms.CoMokx.Defuwoms.CoM7xz.Defuwoms.CoMCnz.Defuwoms.CoMtC3.Defuwoms.CoMnis.Defuwoms.CoMx0t.Defuwoms.CoM308.Defuwoms.CoM8b9.Defuwoms.CoM9tp.Defuwoms.CoMz5t.Defuwoms.CoM3n2.Defuwoms.CoMujq.Defuwoms.CoMDm7.Defuwoms.CoMf0u.Defuwoms.CoM4ix.Defuwoms.CoMeke.Defuwoms.CoMozu.Defuwoms.CoMlBx.Defuwoms.CoM3f6.Defuwoms.CoM0ol.Defuwoms.CoMz1t.Defuwoms.CoM87g.Defuwoms.CoMj6w.Defuwoms.CoMDl7.Defuwoms.CoMB44.Defuwoms.CoM3k6.Defuwoms.CoM10D.Defuwoms.CoM028.Defuwoms.CoM594.Defuwoms.CoM8hf.Defuwoms.CoMo5b.Defuwoms.CoM956.Defuwoms.CoMfi4.Defuwoms.CoMl15.Defuwoms.CoMnrt.Defuwoms.CoM0r7.Defuwoms.CoMhq7.Defuwoms.CoMw1k.Defuwoms.CoM1rn.Defuwoms.CoM658.Defuwoms.CoM8B7.Defuwoms.CoMx3k.Defuwoms.CoMyp2.Defuwoms.CoMt6x.Defuwoms.CoMvgr.Defuwoms.CoMC8z.Defuwoms.CoM41e.Defuwoms.CoMm1y.Defuwoms.CoMxf6.Defuwoms.CoMnj8.Defuwoms.CoMmxz.Defuwoms.CoM28v.Defuwoms.CoMyzh.Defuwoms.CoMttD.Defuwoms.CoMfnw.Defuwoms.CoM3C1.Defuwoms.CoMi66.Defuwoms.CoMl6v.Defuwoms.CoMyCv.Defuwoms.CoMrej.Defuwoms.CoMnke.Defuwoms.CoM