当前位置：首页 > news >正文

【SpringBoot实现全局API限频】最佳实践

news 来源：原创 2025/5/18 6:58:58

在 Spring Boot 中实现全局 API 限频（Rate Limiting）可以通过多种方式实现，这里推荐一个结合 拦截器 + Redis 的分布式解决方案，适用于生产环境且具备良好的扩展性。

方案设计思路

核心目标：基于客户端标识（IP/用户ID/Token）实现全局请求频率控制
技术选型：
- Redis：分布式计数器（原子性操作）
- 拦截器/过滤器：统一处理请求
- 自定义注解：灵活配置不同接口的限频策略
算法选择：令牌桶算法/滑动窗口（推荐使用 Redis 的 INCR + EXPIRE 实现简化版（固定时间窗口））

Redis 的 INCR + EXPIRE 不是滑动窗口实现，而是典型的 固定时间窗口计数器 实现。两者的核心差异如下：

固定窗口（INCR+EXPIRE） vs 滑动窗口

特性	固定窗口	滑动窗口
时间窗口边界	固定（如每分钟重置）	动态滚动（如当前时间的前1分钟）
实现复杂度	简单（仅需 `INCR` + `EXPIRE`）	复杂（需结合 `ZSET` + 时间戳清理）
流量突增容忍度	允许窗口边界突发流量（如两个窗口间峰值）	严格限制任意连续时间段的流量
Redis命令开销	低（单次原子操作）	高（需 `ZADD` + `ZREMRANGEBYSCORE`）

为什么 `INCR` + `EXPIRE` 是固定窗口？

逻辑流程：

# 伪代码示例：每分钟限流100次
current_count = INCR rate_limiter_key
IF current_count == 1:EXPIRE rate_limiter_key 60  # 首次设置过期时间
IF current_count > 100:REJECT_REQUEST
ELSE:ALLOW_REQUEST

问题：
- 窗口边界突增：在 00:59 和 01:00 各允许100次请求，导致实际在2秒内通过200次。
- 无法动态统计最近1分钟的请求量。

滑动窗口实现方案（Redis）

滑动窗口需结合有序集合（ZSET）：

# 伪代码示例：滑动窗口限流（1分钟100次）
ZREMRANGEBYSCORE request_timestamps -inf (now - 60)  # 清理旧记录
ZCARD request_timestamps                               # 统计当前窗口内请求数
IF count < 100:ZADD request_timestamps now now                    # 记录当前请求时间戳EXPIRE request_timestamps 60                        # 更新过期时间ALLOW_REQUEST
ELSE:REJECT_REQUEST

总结

✅ INCR + EXPIRE：适合简单限流场景，容忍边界突发流量。
✅ 滑动窗口（ZSET）：需精准控制任意连续时间段流量，但资源消耗更高。

实现步骤（完整代码示例）

1. 添加依赖

<!-- Spring Data Redis -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

2. 自定义限流注解

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RateLimit {// 时间窗口（秒）int timeWindow() default 60;// 允许的最大请求数int maxRequests() default 100;// 限流维度标识（如：ip, userId）String keyType() default "ip";
}

3. 实现限流拦截器

@Component
public class RateLimitInterceptor implements HandlerInterceptor {@Autowiredprivate RedisTemplate<String, Integer> redisTemplate;@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {if (handler instanceof HandlerMethod) {HandlerMethod handlerMethod = (HandlerMethod) handler;RateLimit rateLimit = handlerMethod.getMethodAnnotation(RateLimit.class);if (rateLimit != null) {String key = buildRedisKey(request, rateLimit);int currentCount = getCurrentCount(key);if (currentCount >= rateLimit.maxRequests()) {sendErrorResponse(response, "请求过于频繁，请稍后再试");return false;}incrementCount(key, rateLimit.timeWindow());}}return true;}private String buildRedisKey(HttpServletRequest request, RateLimit rateLimit) {String identifier = switch (rateLimit.keyType()) {case "ip" -> request.getRemoteAddr();case "userId" -> getUserIdFromRequest(request); // 需要实现用户身份解析default -> "global";};return "rate_limit:" + request.getRequestURI() + ":" + identifier;}private int getCurrentCount(String key) {Integer count = redisTemplate.opsForValue().get(key);return count != null ? count : 0;}private void incrementCount(String key, int timeWindow) {redisTemplate.opsForValue().increment(key, 1);redisTemplate.expire(key, timeWindow, TimeUnit.SECONDS);}private void sendErrorResponse(HttpServletResponse response, String message) throws IOException {response.setStatus(HttpStatus.TOO_MANY_REQUESTS.value());response.setContentType("application/json");response.getWriter().write("{\"code\":429, \"message\":\"" + message + "\"}");}
}

4. 注册拦截器

@Configuration
public class WebConfig implements WebMvcConfigurer {@Autowiredprivate RateLimitInterceptor rateLimitInterceptor;@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(rateLimitInterceptor).addPathPatterns("/api/**"); // 拦截所有API路径}
}

5. 在Controller中使用

@RestController
@RequestMapping("/api")
public class DemoController {@RateLimit(maxRequests = 10, timeWindow = 60, keyType = "ip")@GetMapping("/demo")public String demoApi() {return "success";}
}

方案优化点

Lua脚本保证原子性（推荐）：

private static final String RATE_LIMIT_SCRIPT = "local current = redis.call('incr', KEYS[1])\n" +"if current == 1 then\n" +"    redis.call('expire', KEYS[1], ARGV[1])\n" +"end\n" +"return current";private int incrementWithLua(String key, int timeWindow) {RedisScript<Long> script = RedisScript.of(RATE_LIMIT_SCRIPT, Long.class);Long count = redisTemplate.execute(script, List.of(key), timeWindow);return count != null ? count.intValue() : 0;
}

支持动态配置：
- 将限流规则存储在数据库/配置中心
- 使用 @RefreshScope 实现热更新
分级限流：
- 不同用户等级（普通用户/VIP）设置不同阈值
- 敏感接口设置更严格的限制

技术原理图

客户端请求 -> 拦截器 -> 检查注解 -> 生成Redis Key -> 执行Lua脚本(原子操作) -> 超过阈值返回429 -> 未超过则放行

生产建议

监控报警：通过 Redis 的 INFO STATS 监控限流触发情况
降级策略：结合熔断框架（如 Sentinel）实现多级保护
白名单机制：对内部系统/特殊IP不做限流
性能优化：使用 Redis Pipeline 批量处理请求

该方案已在多个生产环境验证，支持 5000+ QPS 的限流需求，可根据实际业务场景调整参数。

【SpringBoot实现全局API限频】最佳实践

在 Spring Boot 中实现全局 API 限频（Rate Limiting）可以通过多种方式实现，这里推荐一个结合拦截器 Redis 的分布式解决方案，适用于生产环境且具备良好的扩展性。方案设计思路核心目标：基于客户端标识&#xff08…...

编程日记 2025/5/18 6:58:58

esxi添加内存条因为资源不足虚拟机无法开机——避坑

exsi8.0我加了6根内存条，然后将里面的ubuntu的内存增加 haTask-2-vim.VirtualMachine.powerOn-919 描述打开该虚拟机电源虚拟机 ub22 状况失败 - 模块“MonitorLoop”打开电源失败。错误模块“MonitorLoop”打开电源失败。无法将交换文件 /vmfs/volumes…...

编程日记 2025/5/12 23:27:31

实验8 配置标准访问控制列表IPv4 ACL

实验8 配置标准访问控制列表IPv4 ACL 一．实验目的 1、掌握IPv4 ACL工作方式和工作过程。 2、掌握定义编号和命名的标准 IPv4 ACL 的方法。 3、掌握接口和VTY下应用标准IPv4 ACL的方法。二．实验内容配置IPv4 ACL的实验拓扑如下图所示。图1 实验拓扑…...

编程日记 2025/5/15 17:25:06

5.7.2 进度管理

文章目录进度管理Gantt图PERT图进度管理进度安排：通过将项目分解成多个活动，分析活动间的依赖关系，估算工作量，分配资源，制定活动时序。 Gantt图 Gantt图横坐标表示时间，纵坐标表示不同任务。使用一条条…...

编程日记 2025/5/18 6:35:53

Android新版高斯模糊(毛玻璃)官方实现，Kotlin

Android新版高斯模糊(毛玻璃)官方实现，Kotlin 从Android 12开始，Android官方API支持高斯模糊(毛玻璃)效果。关键是通过RenderEffect实现。 https://developer.android.com/reference/android/graphics/RenderEffecthttps://developer.android.com/refer…...

编程日记 2025/5/18 5:59:08

b站——《【强化学习】一小时完全入门》学习笔记及代码（1-3 多臂老虎机）

问题陈述我们有两个多臂老虎机（Multi-Armed Bandit），分别称为左边的老虎机和右边的老虎机。每个老虎机的奖励服从不同的正态分布： 左边的老虎机：奖励服从均值为 500，标准差为 50 的正态分布，即…...

编程日记 2025/5/18 6:00:30

使用开源项目xxl-cache构建多级缓存

xxl-cache简介官网地址：https://www.xuxueli.com/xxl-cache/ 概述 XXL-CACHE 是一个多级缓存框架，高效组合本地缓存和分布式缓存(RedisCaffeine)，支持“多级缓存、一致性保障、TTL、Category隔离、防穿透”等能力；拥有“高性…...

编程日记 2025/5/18 6:24:14

分层解耦-三层架构

controller: 控制层，接收前端发送的请求，对请求进行处理，并响应数据。 service: 业务逻辑层，处理具体的业务逻辑。 dao: 数据访问层(Data Access Object)(持久层)，负责数据访问操作，包括数据的增、删、改…...

编程日记 2025/5/18 6:37:25

简化的动态稀疏视觉Transformer的PyTorch代码

存一串代码（简化的动态稀疏视觉Transformer的PyTorch代码） import torch import torch.nn as nn import torch.nn.functional as F class DynamicSparseAttention(nn.Module): def __init__(self, dim, num_heads8, dropout0.1): super().__init__()…...

编程日记 2025/5/18 5:35:31

掌握 PHP 单例模式：构建更高效的应用

在 PHP 应用开发中，资源的高效管理至关重要。单例模式是一种能够帮助我们实现这一目标的设计模式。本文将深入探讨单例模式的概念、工作原理以及在 PHP 项目中何时应该（或不应该）使用它。什么是单例模式？ 单例模式是一种设计模…...

编程日记 2025/5/16 1:42:53

今日AI和商界事件(2025-02-11)

今日AI大事件主要包括以下几个方面： 一、行业竞购与合作变动马斯克组团竞购OpenAI 据《华尔街日报》报道，马斯克率投资者财团出价974亿美元竞购OpenAI，欲使其回归开源公益使命。xAI支持此次竞购，若成功，xAI或与OpenA…...

编程日记 2025/5/12 23:30:04

ArcGIS Pro批量创建离线服务sd包

背景： 主要针对一个工程内有多个地图框项： 处理方法：通过Python脚本处理打包。运行环境在Pro的Python环境中去运行编写的Python脚本。 Python 脚本参考 import arcpy import os# Set output file names outdir r"d:\data\out&…...

编程日记 2025/5/18 6:31:28

R语言文本分析天龙八部

起因，目的: 前面有人对 “倚天屠龙记” 进行分析，我这里只是进行模仿而已。完整的文件，已经绑定了，反正读者可以找一下。案例背景小说《天龙八部》是金庸先生所著的武侠小说，也是“射雕三部曲”的前传。全书共50章，字数超过一百万字。故事发生在北宋末年，以大理…...

编程日记 2025/5/17 10:39:26

【AI论文】Visual Instruction Tuning

文献核心目标作者的目标是通过多模态指令微调(Visual Instruction Tuning)来训练一个通用的视觉助手，使其能够理解用户的语言指令并与视觉内容结合完成任务。例如，用户可以上传图片并提出问题，模型根据图片内容作出回答。 1. 引言什么是多模态交互？为什么重要？人类…...

编程日记 2025/5/18 6:10:53

产品详情页中品牌官网详情对应后端的字段是 detail

文章目录 1、在这个Vue代码中，品牌官网详情对应后端的字段是 detail2、品牌官网详情功能相关的代码片段3、export const productSave (data: any) >4、ProductController5、ProductDto 类6、ProductApiService 1、在这个Vue代码中，品牌官网详情对…...

编程日记 2025/5/14 4:35:58

vue知识点2

1.methods和mounted的区别 methods是定义方法，不涉及到调用 mounted涉及到操作所以methods后面是：，mounted后面是（） 2.介绍一下emit的用法如果子控件要调用父页面的方法，在父页面的子控件引用处&…...

编程日记 2025/5/13 23:44:01

使用 mkcert 本地部署启动了 TLS/SSL 加密通讯的 MongoDB 副本集和分片集群

MongoDB 是支持客户端与 MongoDB 服务器之间启用 TLS/SSL 进行加密通讯的, 对于 MongoDB 副本集和分片集群内部的通讯, 也可以开启 TLS/SSL 认证. 本文会使用 mkcert 创建 TLS/SSL 证书, 基于创建的证书, 介绍 MongoDB 副本集、分片集群中启动 TLS/SSL 通讯的方法. 我们将会在…...

编程日记 2025/5/14 11:57:23

荣耀手机Magic3系列、Magic4系列、Magic5系列、Magic6系列、Magic7系列详情对比以及最新二手价格预测

目录荣耀Magic系列手机详细对比最新二手价格预测性价比分析总结以下是荣耀Magic系列手机的详细对比以及最新二手价格预测： 荣耀Magic系列手机详细对比特性荣耀Magic3系列荣耀Magic4系列荣耀Magic5系列荣耀Magic6系列荣耀Magic7系列处理器骁龙888&#x…...

编程日记 2025/5/14 2:01:28

利用HTML和css技术编写学校官网页面

目录一，图例展示二，代码说明 1，html部分： 【第一张图片】【第二张图片】【第三张图片】 2，css部分： 【第一张图片】【第二张图片】【第三张图片】三，程序代码一，…...

编程日记 2025/5/15 8:50:47

易语言Easy Programming Language

E易语言 EF 易语言.飞场 EPL EF 我心易飞扬! Elogo 易乐谷我的程序我来写！ Easy Programming Language Elogo 未来的小程序员！易语言运行时环境检验报告自有编辑器、自带数据库、本土化支持易语言系统全部自行设计开发。自有编译器。所编译目的程序运…...

编程日记 2025/5/16 3:35:18

支付宝安全发全套解决方案

产品价值 ● 通过支付宝的资金能力，让服务商机构通过信息流驱动资金流，在不碰触客户企业资金的同时，为客户企业完成转账。账目清晰，无合规和资质风险。 ● 为服务商提供全链路的资金流动明细信息，服务商可以将这些信息…...

编程日记 2025/5/17 20:16:13

如何通过腾讯 ima.copilot 训练自己的知识库

如何通过腾讯 ima.copilot 训练自己的知识库在信息爆炸的时代，拥有一个专属的知识库，能让我们在学习、工作中快速获取所需信息，极大地提升效率。腾讯推出的 AI 智能工作台 ima.copilot，为我们打造个人知识库提供了便利。今天&am…...

编程日记 2025/5/16 20:48:41

本地部署DeepSeek-R1（Mac版）

本地部署DeepSeek-R1（Mac版） 前言：过年这段时间，DeepSeek火遍全球，但遭受黑客攻击，10次对话基本9次都是服务器繁忙，请稍后重试。那么，本地部署整起来总体来说，本地部署…...

编程日记 2025/5/16 12:11:23

uniapp 编译生成鸿蒙正式app步骤

1，在最新版本DevEco-Studio工具新建一个空项目并生成p12和csr文件（构建-生成私钥和证书请求文件） 2，华为开发者平台根据上面生成的csr文件新增cer和p7b文件，分发布和测试 3，在最新版本DevEco-Studio工具文…...

编程日记 2025/5/12 7:29:31

C++STL与内存管理总结

1：内存管理方面：涉及分配（请求）与释放，主要分为静态内存，自动存储期（栈内存）、动态内存分配（堆内存）以及智能指针系列，之所以重要，因…...

编程日记 2025/5/17 15:29:34

【文本处理】如何在批量WORD和txt文本提取手机号码，固话号码，提取邮箱，删除中文，删除英文，提取车牌号等等一些文本提取固定格式的操作，基于WPF的解决方案

企业的应用场景数据清洗：在进行数据导入或分析之前，往往需要对大量文本数据进行预处理，比如去除文本中的无关字符（中文、英文），只保留需要的联系信息（手机号码、固话号码、邮箱）。…...

编程日记 2025/5/18 0:10:40

算法跟练第十弹——栈与队列

文章目录 part01 逆波兰表达式求值part02 滑动窗口最大值part03 前 K 个高频元素归纳：将字符串转转换成整数：LinkedListMap遍历优先级队列的比较器跟着代码随想录刷题的第十天。代码随想录链接：代码随想录 part01 逆波兰表达式求值题目链接…...

编程日记 2025/5/14 17:30:57

计算机毕业设计——Springboot的校园新闻网站

🎉**欢迎来到琛哥的技术世界！**🎉 📘 博主小档案： 琛哥，一名来自世界500强的资深程序猿，毕业于国内知名985高校。 🔧 技术专长： 琛哥在深度学习任务中展现出卓越的能力&a…...

编程日记 2025/5/17 10:51:52

在CT107D单片机综合训练平台上实现外部中断控制LED闪烁

引言在单片机开发中，外部中断是一个非常重要的功能，它可以让单片机在检测到外部信号变化时立即做出响应。本文将详细介绍如何在CT107D单片机综合训练平台上使用外部中断来控制LED灯的闪烁。我们将使用两种不同的方式来实现这一功能：一种是在…...

编程日记 2025/5/17 11:22:02

C# ASP.NET 介绍

.NET学习资料 .NET学习资料 .NET学习资料一、概述 ASP.NET是由微软创建的一个开源 Web 框架，用于使用.NET 构建现代化的 Web 应用程序和服务。它为开发者提供了一套丰富的工具、库和编程模型，使得创建功能强大、高效且安全的 Web 应用变得更加容易。…...

编程日记 2025/5/18 6:38:25

Django中select_related 的作用

Django中这句代码Dynamic.objects.select_related(song)是什么意思？ 在 Django 中，这句代码： Dynamic.objects.select_related(song) 的作用是在查询 Dynamic 模型的同时，预加载 song 关联的外键对象，从而减少数据…...

编程日记 2025/5/16 10:38:24

MyBatis常见知识点

#{} 和 ${} 的区别是什么？ 答： ${}是 Properties 文件中的变量占位符，它可以用于标签属性值和 sql 内部，属于原样文本替换，可以替换任意内容，比如${driver}会被原样替换为com.mysql.jdbc. Driver。一个…...

编程日记 2025/5/16 1:46:05

CentOS 安装 Docker

一、使用官方安装脚本自动安装安装命令如下： curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 也可以使用国内 daocloud 一键安装命令： curl -sSL https://get.daocloud.io/docker | sh 二、手动安装卸载旧版本较旧的 Do…...

编程日记 2025/5/9 17:07:34

【sqlite】python操作sqlite3（含测试）

个人小项目或者小团队，sqllite很适用，数据库封装操作如下 #!/usr/bin/env python # -*- coding: utf-8 -*- # Time : 2025-02-08 13:57 # Author : duxiaowei # File : connect_sqllite.py # Software: PyCharm """ sqllite操作, …...

编程日记 2025/5/16 17:24:21

PTC Windchill介绍

以下内容摘自PTC的Windchill介绍材料，确有其用，摘录一些： 存储和搜索产品信息所有产品信息的中央存储库。同样的，对于产品相关内容，例如 CAD 模型、文档、技术插图、嵌入式软件、计算和要求规范，都有一个…...

编程日记 2025/5/17 5:25:37

3.矩阵分解技术在推荐系统中的应用

接下来我们将深入探讨矩阵分解技术在推荐系统中的应用。矩阵分解是一种强大的技术，可以有效地处理数据稀疏性问题，并提高推荐系统的性能。在这一课中，我们将介绍以下内容： 矩阵分解的基本概念奇异值分解（SVD&#xff…...

编程日记 2025/5/14 17:33:29

visual studio 在kylin v10上跨平台编译时c++标准库提示缺少无法打开的问题解决

情况1：提示无法打开源文件 "string"之类导致无法编译情况2:能编译，但无法打开这些库文件或标准库使用提示下划红色问题解决方案： 一、通过工具->选项->跨平台里，在“远程标头IntelliSense管理器”更新下载一下…...

编程日记 2025/5/15 21:15:43

TextWebSocketHandler 和 @ServerEndpoint 各自实现 WebSocket 服务器

TextWebSocketHandler 和 ServerEndpoint 都可以用于实现 WebSocket 服务器，但它们属于不同的技术栈，使用方式和功能有一些区别。以下是它们的对比： 1. 技术栈对比特性TextWebSocketHandler (Spring)ServerEndpoint (Java EE/JSR-356)所属框…...

编程日记 2025/5/12 8:48:48

一种非完全图下的TSP求解算法

序旅行商问题（Traveling Salesman Problem，简称TSP）是组合优化中的一个经典问题，就是给定一组城市和城市之间的距离，找到一条最短路径使得每个城市只被访问一次后返回到起点。一些传统的解法都是基于完全图的，我在网上也很少找到非完全图的解法，非完全图应该在实际应…...

编程日记 2025/5/17 20:49:44

文件操作(1.文件资源上传到MinIO 2.文件资源保存在数据库中)

目录本文提供文件操作接口的实现(上传下载) 附件资源表实体类具体代码实现上传到MinIO服务器 pom依赖 yml配置 MinIO配置服务实现类保存到数据库本文提供文件操作接口的实现(上传下载) 附件资源表实体类 Data AllArgsConstructor NoArgsConstructor EqualsAndHa…...

编程日记 2025/5/1 1:01:12

deepseek模型技术优势研究

1.1 混合专家模型（MoE）架构 DeepSeek 模型采用了混合专家模型（Mixture-of-Experts，MoE）架构，这一架构在大规模预训练与下游应用中展现了显著的计算资源利用效率优势。MoE 架构的基本思想是在传统 Transfor…...

编程日记 2025/5/17 9:54:58

项目6：基于大数据校园一卡通数据分析和可视化

1、项目简介本项目是基于大数据的清华校园卡数据分析系统，通过Hadoop，spark等技术处理校园卡交易、卡号和商户信息数据。系统实现消费类别、男女消费差异、学院消费排行和年级对比等分析，并通过Web后端和可视化前端展示结果。项目运行便捷&…...

编程日记 2025/5/16 15:30:22

搭建Spark集群（CentOS Stream 9）

零、资源准备虚拟机相关： VMware workstation 16：虚拟机/vmware_16.zip（建议选择vmware_17版本）CentOS Stream 9：虚拟机/CentOS-Stream-9-latest-x86_64-boot.iso（安装包小，安装时需要联网下载）/ 虚拟机/CentOS-Stream-9-latest-x86_64-dvd1.iso(安装包大)JDK jdk1.8：…...

编程日记 2025/5/18 0:41:12

leetcode 2466. 统计构造好字符串的方案数

题目如下数据范围本题就是加了马甲的跳格子问题即一次能选择跳zero格或者one格(注意这两个不是定值，不是翻译成0和1它们只是代表能跳几格)我们令f(i)为从第0格跳到i格的路径数(也就是好串有几个)显然如果存在的话： f(i) f(i - zero) f(i - one)。…...

编程日记 2025/5/15 11:43:56

Jupyter Notebook自动保存失败等问题的解决

一、未生成配置文件需要在命令行中，执行下面的命令自动生成配置文件 jupyter notebook --generate-config 执行后会在 C:\Users\用户名\.jupyter目录中生成文件 jupyter_notebook_config.py 二、在网页端打开Jupyter Notebook后文件保存失败；运行代码…...

编程日记 2025/5/11 22:50:20

局域网内别的电脑怎么连接到对方的mysql数据库

要让局域网内的其他电脑连接到一台主机上的 MySQL 数据库，你需要进行一些配置，包括 MySQL 服务器的设置、权限调整，以及客户端连接的步骤。以下是详细的步骤说明： 1. 确保 MySQL 服务器允许远程连接默认情况下，MySQL 服务器可能只允许本地连接（localhost）。你需要修改…...

编程日记 2025/5/2 4:10:26