讲师中心 微信公众号
AI工具推荐 视频效率加速

如何限制Uvicorn的最大请求大小

星浩酱_7833

星浩酱_7833

发布时间:2026-10-28 10:04:23

|

333人浏览过

|

来源于php中文网

原创

--limit-max-requests控制worker处理请求数上限,与请求体大小无关;真正限制请求头的是--limit-request-field-size和--limit-request-fields;请求体大小需由Nginx、FastAPI(如UploadFile.max_size)及云代理三层协同控制。

如何限制uvicorn的最大请求大小

Uvicorn 启动时用 --limit-max-requests 不能限制请求体大小

这个参数实际控制的是每个 worker 处理的请求数上限,和请求体(body)大小完全无关。混淆它会导致配额误调,413 错误依然出现。真正管请求体大小的是 --limit-request-field-size 和底层 ASGI 协议栈的解析逻辑——但注意,Uvicorn 自身**不直接暴露“最大上传体积”配置项**,它依赖 HTTP 协议实现(如 httptools 或 h11)对 header 和 body 的分段约束。

真正生效的两个关键参数:--limit-request-field-size 和 --limit-request-fields

它们共同影响大文件上传能否抵达应用层:

  • --limit-request-field-size:限制单个 HTTP 请求头字段值的最大字节数,默认 8190。如果上传请求带了超长 Authorization 或自定义 header,可能在此被截断
  • --limit-request-fields:限制请求头中字段总数,默认 100。某些前端 SDK 会塞大量 trace header,触达此限后连接直接关闭,不会进路由

这两个参数作用于解析阶段,早于 FastAPI 的 Request.body() 调用。若你看到日志里有 invalid HTTP header 或连接重置(非 413),大概率是它们卡住了。

业务层必须补上 FastAPI 的 Request 解析限制

Uvicorn 不校验 body 总大小,只负责把已接收的字节流交给 ASGI app。所以 413 真正由框架层抛出时,往往是因为:

Uvicorn 0.52.1
Uvicorn 0.52.1

Uvicorn 0.52.1 是 Python ASGI Web 服务器,提供异步应用服务及 WebSocket 支持,常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理所需依赖。

下载
  • FastAPI 默认使用 Starlette 的 Request.form() 或 Request.body(),而后者默认无上限,但实际受内存和超时制约
  • 更常见的是显式用了 File 或 UploadFile,此时需手动加 max_files / max_file_size 参数
  • 例如:async def upload(file: UploadFile = File(..., max_size=20_000_000)) —— 这个 max_size 才是面向用户的上传配额

漏掉这步,Uvicorn 就算放行了,应用也可能因 OOM 被系统 kill,或者在读 body 时抛 ConnectionResetError。

别忘了 Nginx 或 Cloud Load Balancer 的前置拦截

如果你部署在反向代理后,client_max_body_size(Nginx)、max_request_bytes(Cloudflare)、requestTimeout(ALB)这些配置优先级高于 Uvicorn 和 FastAPI。日志里出现 413 Request Entity Too Large 且 body_bytes_sent=0,基本说明请求根本没到 Uvicorn 进程。

最稳妥的做法是三层对齐:Nginx 配置略宽于业务层限制(比如 Nginx 设 25MB,FastAPI 设 20MB),再在 API 文档里明确标出客户端应遵守的上限值。否则前端传了 22MB 文件,Uvicorn 和 FastAPI 都没报错,却卡死在代理层,排查路径会绕远。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

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

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

DeepSeek

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

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

相关专题

更多
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 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

574

2026.02.06

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

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

656

2026.05.09

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

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

559

2026.06.16

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

0

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

0

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

120

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

60

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方部署指南
Uvicorn官方部署指南

共0课时 | 0人学习

Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

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

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