Spring Boot应用在Maven打包时卡住问题咨询

数据老陈

2026-5-20

解决Maven打包时Spring Boot应用卡在扫描环节的问题

我之前也碰到过类似的糟心事——Spring Boot在IDE里跑应用、跑JUnit测试都顺得很，一用Maven打包就卡在组件扫描环节。结合你描述的情况，我整理了几个排查和解决的思路：

可能的原因分析

扫描范围过载或隐藏的循环依赖：IDE运行时可能有缓存或者简化的上下文初始化策略，就算你设置了多个扫描值也能正常跑，但Maven打包时会加载完整的Spring上下文，这时候多余的扫描目标可能触发意外的Bean初始化，甚至隐藏的循环依赖，直接卡住进程。
Maven打包与IDE运行的上下文差异：执行mvn package时，Spring Boot的打包插件默认会触发上下文初始化校验，这个过程比IDE里跑应用的初始化更严格，一些在IDE里被忽略的问题会暴露出来。
日志粒度不够，看不到卡点细节：默认Maven打包的日志比较简略，你根本不知道扫描到了哪个Bean、卡在了哪一步，自然没法定位问题。

具体解决步骤

1. 调高日志级别，看清扫描全过程

先在application.properties（或.yml）里添加日志配置，让Spring的组件扫描日志更详细：

logging.level.org.springframework.context.annotation=DEBUG
logging.level.org.springframework.beans.factory=DEBUG

然后重新执行mvn package，这时候你能在控制台看到每一个被扫描的Bean、初始化的步骤，精准定位卡住的节点。

2. 缩小组件扫描范围，减少不必要的加载

检查你的@SpringBootApplication注解，默认会扫描当前包及其所有子包。如果有无关的类被错误扫描，手动指定需要扫描的包或类：

@SpringBootApplication(scanBasePackages = "com.your.target.package")
// 或者只扫描特定类，更精准
// @SpringBootApplication(scanBasePackageClasses = {YourCoreService.class, YourApiController.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这样能大幅减少扫描的Bean数量，避免不必要的初始化操作。

3. 排查并解决循环依赖问题

如果日志显示卡在某个Bean的初始化上，重点检查该Bean和其他Bean是否存在循环依赖（比如A依赖B，B又依赖A）。Spring对Setter注入的循环依赖有处理能力，但构造器注入的循环依赖很容易导致卡住。可以改成Setter注入，或者用@Lazy注解延迟加载：

@Service
public class ServiceA {
    private ServiceB serviceB;

    @Autowired
    public void setServiceB(ServiceB serviceB) {
        this.serviceB = serviceB;
    }
}

或者在构造器注入时加@Lazy：

@Service
public class ServiceA {
    private final ServiceB serviceB;

    public ServiceA(@Lazy ServiceB serviceB) {
        this.serviceB = serviceB;
    }
}

4. 临时跳过上下文初始化（应急方案）

如果只是想先完成打包，不想立刻处理根本问题，可以在Maven命令里跳过Spring Boot的上下文校验：

mvn package -Dspring-boot.repackage.skip=true

注意这只是临时方案，跳过这个步骤生成的jar可能无法正常运行，最终还是要解决扫描卡住的根本问题。

另外，你提到“仅期望扫描返回两个值，但设置了多个值以展示卡住情况”，可以先把多余的扫描配置去掉，确认能正常打包后再逐步添加，这样能快速定位是哪个配置触发的卡点。

内容的提问来源于stack exchange，提问作者rakeeee