本方案采用拦截器模式，在请求处理的早期阶段完成限速组件的初始化，通过请求属性传递包装后的响应对象。

本文介绍在 Spring Boot 中实现多维度网络带宽限速的完整方案。基于令牌桶算法手动实现核心逻辑，通过自定义 HandlerInterceptor 拦截请求、HttpServletResponseWrapper 包装响应流、RateLimitedOutputStream 控制输出速率，实现对文件下载、视频流等场景的精确速度控制。

public class BandwidthLimitResponseWrapper extends HttpServletResponseWrapper { private final TokenBucket sharedTokenBucket; // 共享的令牌桶 @Override public ServletOutputStream getOutputStream throws IOException { if { // 使用共享 TokenBucket，确保多维度统计正确 limitedOutputStream = new RateLimitedOutputStream, sharedTokenBucket, bandwidthBytesPerSecond ); } return limitedOutputStream; }} . 拦截器获取包装响应

拦截器在 preHandle 中创建响应包装器，存储到 request attribute，Controller 通过 BandwidthLimitHelper 获取。

@BandwidthLimit@GetMappingpublic void downloadByUser String userType, HttpServletResponse response) throws IOException { // 根据请求头 X-User-Type 自动应用 200KB/s 或 2MB/s 限速} IP 维度限速

根据客户端 IP 地址限速，防止单个 IP 占用过多带宽。支持代理环境下的 IP 获取。

咱就是说IP 限速hen关键哈，你想想，要是某个 IP 一直疯狂下载，那不把服务器带宽占满了其他用户dou别玩了。

// 自动计算@BandwidthLimit// 手动指定@BandwidthLimit

本文基于令牌桶算法，通过 HandlerInterceptor + HttpServletResponseWrapper，在 Spring Boot 中实现了多维度带宽限速。支持全局/API/用户/IP 四种限速维度，提供实时统计监控，适用于API接口保护、文件下载、视频流等场景。

而通过合理的网络限速,Neng够有效限制单位时间内来自同一 IP 或用户的请求数量,让这类恶意攻击难以得逞,保障服务的可用性.

@Overridepublic boolean preHandle { BandwidthLimit annotation = findAnnotation; if { // 从 Manager 获取共享 TokenBucket TokenBucket bucket = limitManager.getBucket; // 创建包装器并存储 BandwidthLimitResponseWrapper wrappedResponse = new BandwidthLimitResponseWrapper; request.setAttribute; } return true;} . Controller 获取限速响应

Controller 通过 BandwidthLimitHelper.getLimitedResponse 获取包装后的响应，所有写入操作dou会自动限速。

. 分块大小影响流量平滑度。将 8KB 数据拆分成 2KB× 次写入，每次写入之间进行令牌检查，比一次性写入 8KB geng加平滑。

. 桶容量决定Neng承受多大突发流量。容量为 200KB 时即使桶Yi满，Zui多也只Neng连续发送 200KB 数据，之后必须等待令牌补充。

. 填充速率决定长期平均传输速度。每秒补充 200KB 令牌，意味着平均速度就是 200KB/s。

每个接口路径独立限速，不同接口的流量互不影响。/api/file/download 限制 500KB/s，/api/video/stream 限制 2MB/s，两个接口Ke以同时达到各自的速度上限。

根据用户标识进行限速，每个用户独立计算带宽。配合 free 和 vip 参数，可实现差异化服务：免费用户200KB/s，VIP 用户2MB/s。

public synchronized void acquire { // . 计算等待时间 if { tokens -= permits; return; } long deficit = permits - tokens; long waitNanos = / refillRate; // . 精确等待 sleepNanos;}

. 分块大小选择：流量平滑利器

经验公式：chunkSize ≈ bandwidthBytesPerSecond / targetTPS

高频小块写入可显著提升平滑度

典型配置：200KB/s 带宽 → chunkSize=4KB