Spring Boot 2.5.4中@PostConstruct搭配@Async不生效导致接口阻塞如何解决

你的问题核心是@Async注解未生效，导致阻塞了Spring容器初始化流程：

1. 首先你没有开启Spring异步功能，@Async注解默认不会生效，startMonitoring方法是同步执行的
2. @PostConstruct会在Bean初始化阶段被Spring主线程调用，方法里的watchService.take()是阻塞API，没有文件变动时会一直卡住，从你提供的启动日志也能看出：日志只打印到START_MONITORING，没有后续Tomcat启动完成的日志，说明服务根本没有完成初始化，接口自然无法访问
3. 即使注释掉@PostConstruct接口能访问，你直接调用restart接口时，方法还是同步执行，请求会被直接阻塞直到超时

按以下步骤改造即可实现后台异步监控，不阻塞任何调用方：

1. 开启Spring异步支持：在启动类上添加@EnableAsync注解
2. 调整监控启动时机：不要用@PostConstruct触发异步方法，Bean初始化阶段代理对象还未完全生成，很容易导致异步失效，改为监听ContextRefreshedEvent事件，等Spring容器完全初始化完成后再启动监控
3. 添加运行状态控制：避免重复启动监控线程，同时支持重启时中断原有线程

1. 启动类改造 #

@SpringBootApplication
@EnableAsync // 新增：开启异步方法支持
public class BatchProcessorApplication {
    public static void main(String[] args) {
        SpringApplication.run(BatchProcessorApplication.class, args);
    }
}

2. FileMonitorService改造 #

@Slf4j
@Service
@AllArgsConstructor
public class FileMonitorService {

    private final AppProperties appProperties;
    private final WatchService watchService;
    private final RestTemplate restTemplate;

    // 新增：监控运行状态标记，避免重复启动
    private final AtomicBoolean isMonitoring = new AtomicBoolean(false);
    // 新增：保存监控线程，用于重启时中断
    private Thread monitorThread;

    // 新增：容器初始化完成后触发监控启动，替代@PostConstruct
    @EventListener(ContextRefreshedEvent.class)
    public void initMonitor() {
        startMonitoring();
    }

    @Async
    public void startMonitoring() {
        // 已经在运行直接返回
        if (!isMonitoring.compareAndSet(false, true)) {
            log.warn("文件监控已经在运行，无需重复启动");
            return;
        }
        monitorThread = Thread.currentThread();
        FileUtils.setAppProperties(appProperties);
        FileUtils.setRestTemplate(restTemplate);
        FileUtils.readFilesForDirectory();
        log.info("START_MONITORING");
        try {
            WatchKey key;
            while ((key = watchService.take()) != null) {
                for (WatchEvent<?> event : key.pollEvents()) {
                    log.info("Event kind: {}; File affected: {}", event.kind(), event.context());
                    if((event.kind() == StandardWatchEventKinds.ENTRY_CREATE ||
                            event.kind() == StandardWatchEventKinds.ENTRY_MODIFY) &&
                            event.context().toString().contains(".xml")){
                        try {
                            restTemplateRequest(event.context().toString()+" processing");
                            FileUtils.readXml(Path.of(FileUtils.getFileAbsolutePath(appProperties.getDataIn()),
                                    event.context().toString()));
                        }catch (Exception e){
                            log.error("startMonitoring Exception: "+e.getMessage());
                        }
                    }
                }
                key.reset();
            }
        } catch (InterruptedException e) {
            log.warn("startMonitoring: 监控服务被中断: "+e.getMessage());
        } finally {
            // 重置状态标记
            isMonitoring.set(false);
        }
    }

    // 新增：停止监控方法
    public void stopMonitoring() {
        if (isMonitoring.get() && monitorThread != null) {
            monitorThread.interrupt();
            log.info("文件监控已停止");
        }
    }
}

3. Controller改造 #

@RestController
@RequestMapping("/xml")
public class FileController {

    @Autowired
    FileMonitorService fileMonitorService;

    @GetMapping("/restart")
    public String restartFileMonitoring(){
        fileMonitorService.stopMonitoring();
        fileMonitorService.startMonitoring();
        return "File monitoring restarted successfully";
    }
}

改造完成后，监控会在后台独立线程运行，不会阻塞Spring初始化和接口调用，重启接口也可以正常访问和执行。

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