告别 "Bean Not Found"!轻松搞定 Spring Boot 包扫描难题 ✅

本文已收录在Github,关注我,紧跟本系列专栏文章,咱们下篇再续!

  • 🚀 魔都架构师 | 全网30W技术追随者
  • 🔧 大厂分布式系统/数据中台实战专家
  • 🏆 主导交易系统百万级流量调优 & 车联网平台架构
  • 🧠 AIGC应用开发先行者 | 区块链落地实践者
  • 🌍 以技术驱动创新,我们的征途是改变世界!
  • 👉 实战干货:编程严选网

0 前言

SpringBoot约定大于配置,但不熟悉所有约定,所以经常写bug!

1 案例:扫描不到Bean定义

Spring Boot服务包结构:

BestPractiseApplication:

java 复制代码
package com.javaedge.spring.aop;

/**
 * @author JavaEdge
 */
@SpringBootApplication
public class BestPractiseApplication {

    public static void main(String[] args) {
        SpringApplication.run(BestPractiseApplication.class, args);
    }
}

MyController:

java 复制代码
package com.javaedge.spring.app;

/**
 * @author JavaEdge
 */
@RestController
public class MyController {

    @GetMapping("hello")
    public String hello() {
        return "hello Java";
    }
}

访问http://localhost:12345/hello:

紧急需求,需添加多个Controller,常规操作调整包结构:

发现应用不识别MyController,找不到 MyController 这 Bean,why?

2 解惑

2.1 之前为啥生效?

@SpringBootApplication继承了其它注解:

java 复制代码
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {

SpringBootApplication默认开启ComponentScan。SpringBoot应用启动时,ComponentScan扫描所有定义的 Bean,扫描位置由 ComponentScan 的 basePackages 属性指定:

java 复制代码
package org.springframework.context.annotation;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
@Repeatable(ComponentScans.class)
public @interface ComponentScan {

	@AliasFor("basePackages")
	String[] value() default {};

	@AliasFor("value")
	String[] basePackages() default {};

但basePackages默认空,那它扫描的啥包?debug 到 ComponentScanAnnotationParser#parse:

即declaringClass所在包,即com.javaedge.app。

3 修正

如下两种方案:

3.1 放好位置

3.2 显式配置

@ComponentScan

java 复制代码
package com.javaedge.spring.app;

@SpringBootApplication()
@ComponentScan("com.javaedge.spring.controller")
public class BestPractiseApplication {

    public static void main(String[] args) {
        SpringApplication.run(BestPractiseApplication.class, args);
    }
}

@ComponentScans

java 复制代码
package com.javaedge.spring.app;

@SpringBootApplication()
@ComponentScans(value = {@ComponentScan(value = "com.javaedge.spring.controller")})
public class BestPractiseApplication {

    public static void main(String[] args) {
        SpringApplication.run(BestPractiseApplication.class, args);
    }
}

ComponentScans 相比 ComponentScan,可指定扫描多个包范围。

本文由博客一文多发平台 OpenWrite 发布!

相关推荐
JonaHu19 分钟前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
prince_zxill1 小时前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
少司府1 小时前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
伞伞悦读2 小时前
【第90期】KNN分类回归流水线与K值对照的实验与排查
大数据·人工智能·python·深度学习·机器学习
console.log('npc')3 小时前
Python 学习教程 · 第4课:数据结构
数据结构·python·学习
honker_X3 小时前
Python字符串全攻略:从入门到精通
开发语言·python
贾公子3 小时前
异步检测的轮询与超时——别把「还没好」当成「失败了」
后端·python
吃我一窝jio3 小时前
Docker+Jenkins+K8s全流程部署
java·开发语言·笔记·python
欢乐马87914 小时前
优化|MPSolver 和 pywraplp 到底谁是谁?一次讲清 OR-Tools 的三层结构
python
mengge.cloud6 小时前
Python基础保姆级!从入门到入土
开发语言·python·云原生·pygame