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

星浩酱_7833

星浩酱_7833

2026-10-28

333人浏览

原创

--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 都没报错,却卡死在代理层,排查路径会绕远。

相关文章

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

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

下载

相关标签:

uvicorn

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

574

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

656

23

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

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

2026.06.16

559

12

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

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

2026.10.28

0

16

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

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

2026.10.28

0

15

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

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

2026.10.28

0

10

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

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

2026.10.22

120

11

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

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

2026.10.22

60

10

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习