讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

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

落瑶君_8338

落瑶君_8338

发布时间:2026-11-18 08:50:27

|

269人浏览过

|

来源于php中文网

原创

在 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 个请求到来,它将等待前几个请求完成并释放信号量后才能继续处理。这验证了依赖项确实起到了限流作用。

fastapi-pro
fastapi-pro

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

下载

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

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

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 < max_concurrency:
         # 注意:直接操作 _value 不推荐,通常用 acquire_nowait
         pass
    
    # 使用 acquire_nowait 实现非阻塞限流
    try:
        semaphore.acquire_nowait()
    except asyncio.InvalidStateError:
        raise HTTPException(status_code=429, detail="Too many requests")
    
    try:
        yield
    finally:
        semaphore.release()

@app.get("/strict")
async def strict_endpoint(_: None = Depends(strict_limit_concurrency)):
    await asyncio.sleep(1) # 模拟耗时操作
    return {"status": "processed"}

使用这段代码,当并发请求超过设定的阈值时,额外的请求会立即收到 429 状态码,而不是无限期等待。通过测试可以发现,前两个请求正常处理,第三个请求瞬间报错。这展示了如何通过调整依赖逻辑来改变并发限制的行为模式,从“排队”变为“拒绝”。

基于程序中某个输入、条件或结果的具体问题

在上述代码中,我们使用了 `asyncio.Semaphore` 来控制并发。一个具体的问题是:如果在依赖函数内部发生了未捕获的异常,信号量是否会被正确释放?答案是肯定的,只要我们将释放逻辑放在 `finally` 块中。在我们的示例中,`try...finally` 结构确保了即使业务逻辑抛出异常,`semaphore.release()` 也会被调用,从而避免信号量泄漏导致后续所有请求永久挂起。这是实现可靠并发限制的关键细节。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

119

2025.12.22

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

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

594

2026.02.06

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

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

796

2026.05.09

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

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

679

2026.06.16

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

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

140

2026.11.12

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

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

100

2026.11.12

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

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

80

2026.11.12

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

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

160

2026.11.06

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

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

140

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn