Java + Spring Boot 后端防抖应用实例

防抖工具（适用单机部署）DebounceUtil.java

package com.weiyu.utils;

import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;
import org.springframework.stereotype.Component;

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;

/**
 * 防抖工具（适用单机部署）
 */
@Component
public class DebounceUtil {

    private final Map debounceMap = new ConcurrentHashMap<>();
    private ScheduledExecutorService scheduler;

    @PostConstruct
    public void init() {
        scheduler = Executors.newSingleThreadScheduledExecutor();
    }

    @PreDestroy
    public void destroy() {
        if (scheduler != null) {
            scheduler.shutdown();
        }
    }

    /**
     * 检查并设置防抖状态
     * @param key 唯一标识
     * @param delay 防抖时间（毫秒）
     * @return true 允许操作
     */
    public boolean checkAndSet(String key, long delay) {
        if (debounceMap.containsKey(key)) {
            // 在冷却期内
            return false;
        }

        // 增加 key
        debounceMap.put(key, true);

        // 延迟后移除 key
        scheduler.schedule(() -> debounceMap.remove(key), delay, TimeUnit.MILLISECONDS);

        return true;
    }
}

在 Controller 层中使用防抖工具

WarehouseController.java

......

public class WarehouseController {
    ......

    // 自动注入防抖工具
    @Autowired
    private DebounceUtil debounceUtil;

    // 查询待入库的出库明细数据
    @GetMapping("/ckd/queryDetailForRk")
    public Result> queryCkDetailForRk(@RequestParam String ckNo) {
        log.info("【出库】，查询明细数据，/warehouse/ckd/queryDetailForRk，ckNo = {}", ckNo);

        // 防抖增加的代码
        //#####################################################################
        String debounceKey = "/warehouse/ckd/queryDetailForRk:" + PublicUtils.getUserName();
        // 1秒内防抖
        long debounceTime = 1000;
        if (!debounceUtil.checkAndSet(debounceKey, debounceTime)) {
            throw new RuntimeException("操作过于频繁，请稍后再试");
        }
        //#####################################################################

        List ckDetailList = warehouseService.queryCkDetailForRk(ckNo);
        return Result.success(ckDetailList);
    }
}

页面应用效果：