FastAPI 0.163用Depends(max_concurrency)限制依赖并发数

落瑶君_8338

落瑶君_8338

2026-11-18

269人浏览

原创

在 fastapi 0.163 中,可以通过自定义依赖项配合信号量(semaphore)或异步队列来实现并发限制。具体做法是创建一个全局的信号量实例,并在依赖函数中使用 `async with` 语句获取锁,从而控制同时进入处理逻辑的任务数量。这样做可以防止后端服务被突发流量压垮,确保系统稳定性。

FastAPI 0.163用Depends(max_concurrency)限制依赖并发数

如何定义并注册并发限制依赖

要限制并发数,核心在于使用 `asyncio.Semaphore`。你需要在全局作用域初始化一个信号量,然后在依赖函数中将其作为参数注入。当请求到达时,依赖函数会尝试获取信号量,如果当前活跃请求数未达到上限,则允许继续执行;否则,请求将被挂起等待。这种机制天然支持异步环境,不会阻塞事件循环。

FastAPI 0.163用Depends(max_concurrency)限制依赖并发数

import asyncio
from fastapi import FastAPI, Depends, HTTPException

app = FastAPI()
# 设置最大并发数为 5
semaphore = asyncio.Semaphore(5)

async def limit_concurrency():
    # 尝试获取信号量,如果超过5个并发请求,这里会等待
    await semaphore.acquire()
    try:
        yield
    finally:
        # 无论成功还是异常,释放信号量
        semaphore.release()

@app.get("/data")
async def get_data(_: None = Depends(limit_concurrency)):
    return {"status": "ok", "message": "Processing within concurrency limit"}

运行上述代码后,访问 `/data` 端点。如果同时发起的请求少于或等于 5 个,它们将立即返回结果。如果第 6 个请求到来,它将等待前几个请求完成并释放信号量后才能继续处理。这验证了依赖项确实起到了限流作用。

如何处理并发超限时的错误响应

默认的 Semaphore 行为是让请求排队等待,但在某些场景下,开发者可能希望直接拒绝超出限制的请求。可以通过检查信号量的剩余值或在获取失败时抛出异常来实现。更常见的做法是结合超时机制,或者在获取信号量之前先判断当前状态。不过,最稳健的方式通常是让请求等待,但为了演示如何主动干预,我们可以修改依赖逻辑,使其在无法立即获取资源时返回 429 Too Many Requests。

fastapi-pro
fastapi-pro

使用 FastAPI、SQLAlchemy 2.0 和 Pydantic V2 构建高性能异步 API。精通微服务、WebSocket 和现代 Python 异

下载

FastAPI 0.163用Depends(max_concurrency)限制依赖并发数

import asyncio
from fastapi import FastAPI, Depends, HTTPException

app = FastAPI()
max_concurrency = 2
semaphore = asyncio.Semaphore(max_concurrency)

async def strict_limit_concurrency():
    # 尝试非阻塞获取,如果失败则立即抛出异常
    if not semaphore.locked() and semaphore._value <p>使用这段代码,当并发请求超过设定的阈值时,额外的请求会立即收到 429 状态码,而不是无限期等待。通过测试可以发现,前两个请求正常处理,第三个请求瞬间报错。这展示了如何通过调整依赖逻辑来改变并发限制的行为模式,从“排队”变为“拒绝”。</p><h2>基于程序中某个输入、条件或结果的具体问题</h2><p>在上述代码中,我们使用了 `asyncio.Semaphore` 来控制并发。一个具体的问题是:如果在依赖函数内部发生了未捕获的异常,信号量是否会被正确释放?答案是肯定的,只要我们将释放逻辑放在 `finally` 块中。在我们的示例中,`try...finally` 结构确保了即使业务逻辑抛出异常,`semaphore.release()` 也会被调用,从而避免信号量泄漏导致后续所有请求永久挂起。这是实现可靠并发限制的关键细节。</p>

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

fastapi

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

2025.12.22

119

5

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

2026.02.06

594

18

Python Web框架FastAPI 全栈开发教程合集
Python Web框架FastAPI 全栈开发教程合集

以 FastAPI 为核心,讲解现代 Python Web API 的高效开发方式,涵盖路由定义与路径参数/查询参数/请求体绑定、Pydantic 模型的数据校验与序列化、依赖注入(Depends)系统的分层设计、中间件与 CORS 配置、OAuth2 + JWT 认证流程、后台任务(BackgroundTasks)、WebSocket 实时通信、SQLAlchemy 异步 ORM 集成、自动生成 OpenAPI/Swagger 交互文

2026.05.09

796

23

Python FastAPI异步微服务与高性能接口设计
Python FastAPI异步微服务与高性能接口设计

本专题聚焦 Python FastAPI 框架在高性能接口与微服务开发中的应用,讲解异步请求处理、依赖注入机制、路由设计、数据库异步操作以及接口性能优化策略。结合实际项目案例,帮助开发者构建高并发、低延迟的现代化后端服务架构。

2026.06.16

679

12

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程