uvicorn是啥

【核心技术二】Uvicorn:高性能 ASGI 服务器 Uvicorn 是一个基于 uvloop 和 httptools 构建的快速 ASGI(Asynchronous Server Gateway Interface)服务器实现。它专为运行异步 Python Web 应用程序而设计,特别适合与 FastAPI、Starlette 等现代异步框架配合使用。Uvicorn 作为高性能 ASGI 服务器,凭借其出色的异步处理能力和简洁的使用方式,已成为现代 Python Web 开发的首选服务器。 阅读详情

uvicorn 是 Python 生态中专门用于运行 ASGI 应用 的高性能异步 Web 服务器,也是 FastAPI、Starlette 等现代异步 Web 框架的官方推荐服务器。下面从核心概念、作用、使用方式等维度讲清楚:

一、先搞懂:ASGI 是什么?

要理解 uvicorn,先明确它的运行标准:

  • Web 服务器和应用之间的通信需要遵循统一规范:
    • 传统同步框架(如 Flask/Django<3.0)遵循 WSGI 规范(Web Server Gateway Interface);
    • 现代异步框架(FastAPI/Starlette/Django≥3.0)遵循 ASGI 规范(Asynchronous Server Gateway Interface)—— 支持异步、WebSocket、HTTP/2 等特性。
  • uvicorn 是 ASGI 服务器,专门适配遵循 ASGI 规范的应用,是连接“客户端请求”和“你的 Python 应用代码”的中间层。

二、uvicorn 核心作用

简单说:uvicorn 帮你把写好的 FastAPI/Starlette 代码“跑起来”,成为可对外提供服务的 Web 服务,核心职责包括:

  1. 监听网络端口:比如监听 localhost:8000,接收客户端(浏览器/Postman 等)的 HTTP 请求;
  2. 解析 HTTP 请求:把原始的 HTTP 报文解析成 Python 应用能识别的格式(如请求路径、参数、请求体);
  3. 调度应用代码:将解析后的请求传递给你的 FastAPI 应用(如 app 实例),调用对应的路由函数(如 hello());
  4. 返回响应:把应用代码的返回值(如 {"msg": "Hello, world!"})封装成 HTTP 响应报文,返回给客户端;
  5. 异步高性能:基于 Python 的 asyncio 实现异步 I/O,并发处理请求的能力远优于传统 WSGI 服务器(如 Gunicorn 同步模式)。

三、uvicorn 基本使用方式

1. 安装
pip install uvicorn
# 如果需要支持 HTTP/2、WebSocket 等高级特性,安装完整版:
pip install "uvicorn[standard]"
2. 核心运行命令

格式:uvicorn <模块名>:<应用实例名> [可选参数]
以你之前的 FastAPI 代码(文件名为 main.py)为例:

# 基础运行:监听 127.0.0.1:8000,代码修改后不会自动重启
uvicorn main:app

# 开发环境常用(--reload 热重载:代码修改后自动重启服务器)
uvicorn main:app --reload

# 自定义端口/主机(比如对外网开放,监听所有IP的8888端口)
uvicorn main:app --host 0.0.0.0 --port 8888 --reload

参数说明:

  • main:app:main 是你的 Python 文件名(模块名),app 是文件中创建的 FastAPI 实例(app = FastAPI());
  • --reload:开发模式专用,代码修改后自动重启(生产环境禁止使用,会有性能损耗);
  • --host 0.0.0.0:允许外部设备访问(默认只允许本机 127.0.0.1 访问);
  • --port:指定监听端口(默认 8000)。
3. 生产环境使用

uvicorn 是单进程服务器,生产环境通常搭配 Gunicorn(多进程管理器)使用:

  • Gunicorn 作为主进程,管理多个 uvicorn 工作进程,提升并发和稳定性;
  • 命令示例:
    # 安装 gunicorn
    pip install gunicorn
    
    # 启动 4 个 uvicorn 工作进程
    gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
    

四、uvicorn 与 FastAPI 的关系

  • FastAPI:是 Web 框架,负责定义路由、处理业务逻辑、校验参数、生成文档等;
  • uvicorn:是 Web 服务器,负责把 FastAPI 应用暴露成可访问的 Web 服务;
  • 类比:FastAPI 是“厨师”(处理核心业务),uvicorn 是“餐厅服务员”(接收顾客请求、传递给厨师、返回菜品)。

五、关键特性

  1. 支持异步/同步应用(兼容 WSGI 应用,可运行 Flask/Django);
  2. 原生支持 WebSocket、HTTP/2;
  3. 轻量、易配置,与 FastAPI 无缝集成;
  4. 开发模式的热重载(--reload)大幅提升开发效率。

总结:uvicorn 是运行 FastAPI 等异步 Web 应用的“必备工具”,是连接你的代码和外部请求的桥梁,核心价值是高性能地处理异步 Web 请求。

uvicorn和gunicorn有什么区别? uvicorn和gunicorn是两个用于运行 Python Web 应用程序的不同工具。uvicornuvicornuvicornasynciouvicorngunicorngunicorngunicorngeventeventletgunicornuvicorngunicorn在某些情况下,你也可以结合使用两者。例如,使用gunicorn作为前端服务器,而在其中运行uvicorn作为后端,以支持异步应用程序。 阅读详情

相关推荐

DjangoREST使用Uvicorn部署笔记

说明 血与泪水的结晶,折腾到凌晨2点钟都没弄好一度怀疑自己的智商。 基础环境的安装 #最好先更新一下pip至最新版本 python -m pip install --upgrade pip # 安装uvicorn和gunicorn python -m pip install uvicorn gunicorn # 如果安装缓慢或者超时,可以使用清华镜像加速 python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple uvicorn g

未金涛的博客 3094

uvicorn,一个无敌的 Python 库!

我们学习Python必然是为了找到高薪的工作,下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料,并且有阿里大佬给出了权威的解答,刷完这一套面试资料相信大家都能找到满意的工作。Python所有方向的技术点做的整理,形成各个领域的知识点汇总,它的用处就在于,你可以按照上面的知识点去找对应的学习资源,保证自己学得较为全面。Uvicorn 提供了丰富的配置选项,以满足不同需求。观看零基础学习视频,看视频学习是最快捷也是最有效果的方式,跟着视频中老师的思路,从基础到深入,还是很容易入门的。

m0_59236602的博客 1万+

为什么 Uvicorn 的性能不如 uWSGI?你真的用对了吗?

Uvicorn 是一个基于 ASGI 的快速 Web 服务器,号称性能赶超 uWSGI。然而,有些人在实际使用中发现 Uvicorn 的性能不如 uWSGI。那么,Uvicorn 真的不如 uWSGI 吗?其实,问题可能出在使用方法上。总之,理解你的应用需求,并合理配置服务器,是优化性能的关键。希望通过这篇文章,你能够更好地选择和配置适合你的 Web 服务器。

weixin_41701856的博客 1579

Python Uvicorn 简介

Uvicorn 简介 uvicorn是一个基于asyncio开发的一个轻量级高效的web服务器框架 uvicorn 设计的初衷是想要实现两个目标: 使用uvloop和httptools 实现一个极速的asyncio服务器 实现一个基于ASGI(异步服务器网关接口)的最小应用程序接口。 它目前支持http, websockets, Pub/Sub 广播,并且可以扩展到其他协议和消息类型。 安装使用 uvicorn 仅支持python 3.5.3以上版本,我们可以通过pip3来快速的安装。 Tip:建议和我

m0_37531129的博客 3万+

【Python】Uvicorn服务器

Uvicorn既不是一个传统的“框架”,也不是一个普通的“包”,而是一个专为Python设计的快速服务器,广泛用于构建和部署高性能的异步 Web 服务。

xiaodoudouer的博客 1784

Uvicorn:安装、部署与开发详解

使用 uvloop 和 httptools 实现一个极速的 asyncio 服务器。实现一个基于 ASGI(异步服务器网关接口)的最小应用程序接口。Uvicorn 目前支持 HTTP、WebSockets 和 Pub/Sub 广播,并且可以扩展到其他协议和消息类型。它基于 uvloop 和 asyncio 实现,提供了极高的性能,适用于处理大量并发请求和高吞吐量的场景。

笔者从事电信媒体开发多年,愿意将多年的开发经验分享给同行 1873

【Python】Uvicorn:Python 异步 ASGI 服务器详解

Uvicorn 是一个为 Python 设计的 ASGI(异步服务器网关接口)Web 服务器。它填补了 Python 在异步框架中缺乏一个最小化低层次服务器/应用接口的空白。Uvicorn 支持 HTTP/1.1 和 WebSockets,是构建现代异步Web应用的强大工具。

技术无疆 7716

AHB不对称半桥反激电路设计(三)主要器件参数规格计算

本文介绍了AHB拓扑变压器的设计步骤与核心参数计算,包括主控芯片选择、工作原理分析及参数计算。作者选择DK87XXD集成MOS方案,详细阐述了输入电压范围、反射电压限定、匝比计算、工作频率设定、原副边电流值、电感量计算、磁芯选择、匝数计算、谐振电容设计等关键步骤。通过公式推导与实例计算,展示了150W电源的变压器设计过程,最终确定匝比5.5、原边22匝、副边4匝、电感量200uH等参数。文章还讨论了谐振电容与漏感的关系,为后续调试提供理论基础。该设计方法结合理论分析与工程实践,适用于AHB拓扑电源开发。

【Simon】的博客 3346

uvicorn日志清空问题以及uvicorn日志配置

1、默认的uvicorn的日志清空存在BUG,建议不要使用2、采用按一定的间隔来生成文件的策略更简单,让Python自己来维护日志文件的生成与清理。

duzm200542901104的专栏 2192

Vivado FFT IP核配置与实战:FPGA信号处理硬件加速指南

快速傅里叶变换(FFT)是数字信号处理(DSP)中的核心算法,用于将时域信号转换到频域进行分析。其原理基于离散傅里叶变换(DFT),通过蝶形运算的分解与复用,大幅降低了计算复杂度。在工程实践中,软件实现的FFT难以满足高速实时处理的需求,因此硬件加速方案至关重要。FPGA凭借其并行架构和可定制性,成为实现高性能FFT的理想平台。通过集成专用的FFT IP核,如Vivado中的Pipelined Streaming I/O架构,可以构建流水线化的计算引擎,实现极低延迟和高吞吐量的连续数据流处理。这种硬件方案特

weixin_42536863的博客 650

【中软软件测试笔试题】中国软件与技术服务股份有限公司笔试一卷

请分别写出ISO7层架构,并分别说明TCP、UDP协议分别在处于哪一层,以及TCP、 UPD协议有什么区别。 答:7 应用层 6 表示层 5 会话层 4 传输层 3网络层 2 数据链路层 1 物理层 第四层;UDP是面向无连接、不可靠数据传输协议; TCP是面向连接、可靠数据传输协议......

Yanan990830的博客 1817

生产环境使用Uvicorn和Nginx部署Django

原作:Valentino Gagliardi翻译:大江狗首。翻译时有删减。原文链接:https://www.valentinog.com/blog/uvicorn-django/Djan...

大江狗 8987

【IT小趣闻】免费的DeepSeek是如何赚钱的?

导语:目前很多的通用人工智能也就是所谓的AGI例如文心一言、豆包、通义千问和最近大火的DeepSeek都是免费给普通用户使用的,对开源商业模式不太熟悉的普通人可不太了解这免费背后的商业套路,下面我们就一起来揭秘。开源模式能降低用户信任成本、加速技术普及,而商业化服务则针对企业级需求。DeepSeek 可通过组合上述策略,在服务开发者社区的同时,满足企业客户的深度需求,实现可持续发展。你也看出来了,上边是DeepSeek生成的,讲的还是挺明白的。

SunMy的博客 1771

nginx如何配合uvicorn工作

Nginx 和 Uvicorn 通常一起用于部署基于 Python 的异步 Web 应用程序(如 FastAPI 或 Starlette)。Uvicorn 是一个轻量级的 ASGI(Asynchronous Server Gateway Interface)服务器,用于运行异步 Python Web 应用,而 Nginx 则作为反向代理服务器,处理客户端请求并将它们转发给 Uvicorn。

鸭梨的博客 1331

评分卡建模学习(一)————数据预处理part.3

目录六、数据处理的思路及代码(一)对缺失值的处理:在我这个数据预处理的part.1板块(二)对异常值的处理:在我这个数据预处理的part.2板块(三)数据归一化、标准化:在我这个数据预处理的part.2板块(四)非结构化数据转变+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++———————————————————————————————————————————++++++++++++++++++++++++++

Morven_dai的博客 898

12、有杆泵抽油系统:原理、性能与选择

本文全面介绍了有杆泵抽油系统的原理、性能分析和设备选择方法。有杆泵抽油系统广泛应用于石油开采领域,通过地面抽油装置与井下柱塞泵的配合,实现高效、稳定的原油提升。文章详细解析了系统的工作原理、组成结构、光杆运动特性、载荷计算、泵输送能力及功率需求,并提供了抽油装置的选择流程和实际案例分析。此外,还探讨了泵的容积效率影响因素、示功图的作用及系统优化运行的建议,为石油开采工程提供了理论支持和实践指导。

gan8painter的博客 435

快速了解FastAPI与Uvicorn是什么?

FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints. 本文带你快速了解FastAPI与Uvicorn是什么?

penriver的博客 3064

《大数据最全面试题-Offer直通车》目录

做好这些不用担心试用期不通过:程序员入职新公司如何快速上手项目本人遇到大数据面试题和参考答案(超过1万字精华版)大数据面试英文自我介绍参考(万字长文)大数据运维应用场景面试题汇总及参考答案(持续更新)万字数据仓库面试题及参考答案数据仓库数据质量监控和处理方法最佳实践数据仓库建模方法万字详解Doris的3种数据模型详解和数据仓库每一层的模型选用大数据面试临阵磨枪不知看什么?看这份心理就有底了-大数据常用技术栈常见面试100道题最全Hive面试题2024年(2万字详解)Elasticsearch 面试题及参考答

大模型大数据攻城狮的专栏 2654

Gunicorn 与 Uvicorn 部署 Python 后端详解

本文介绍了Python Web应用在生产环境中的部署方案。对于Flask等WSGI应用,推荐使用Gunicorn作为服务器;对于FastAPI等ASGI应用,可选择Uvicorn或多worker模式,也可通过Gunicorn配合Uvicorn Worker运行。文章详细说明了关键配置参数如worker数量、超时设置、日志管理等,并提供了systemd服务配置示例。同时强调了生产环境中应通过Nginx反向代理、配合进程管理工具实现稳定部署。这些方案能够有效提升Python Web应用在生产环境中的并发性能和稳

记录从移动端、鸿蒙到物联网与AI的完整实战与思考。专注于分享可复用的工程方案与产品思维,尤其深入鸿蒙生态与全栈开发。以十年工程与管理沉淀,为你提供清晰的技术纵深路径。坚信技术的价值在于“贯通”与“落地”。 1万+

Python 爬虫教程:金融数据定向抓取(银行 + 投资网站数据结构化提取)

在当今数字化时代,金融数据的获取和分析对于投资者、分析师以及金融机构来说至关重要。Python 爬虫技术可以帮助我们高效地从各种网站上抓取金融数据,从而为投资决策、风险评估和市场分析提供支持。本文将详细介绍如何使用 Python 爬虫技术来定向抓取银行和投资网站的数据,并将其结构化提取,以便进一步分析和使用。

u014481728的博客 885

贝叶斯统计 [韦来生编]

贝叶斯(Bayes)统计是近几十年来迅速发展起来的数理统计的一个重要分支。贝叶斯方法与经典统计方法的主要不同之处是进行统计推断时除了利用样本信息外,还要利用参数的先验信息,因此可以提高统计推断或统计决策的效果。它在经济、金融、生物、医学、自然科学和社会科学等许多领域具有广泛的应用。贝叶斯方法的研究已渗透到了统计学的几乎所有领域。作者在给中国科学技术大学概率论与数理统计专业本科生开设的“数理统计”课程中有一章专门讲授“贝叶斯方法和统计决策理论”,近十年来也给中国科学技术大学概率统计专业研究生开设过几次“贝叶斯分析”课。本书是在对过去讲稿的内容作了适当的增减和调整的基础上完成的。  本书共分六章。第1章是绪论,介绍了贝叶斯统计的若干基本概念,同时对必要的数理统计的基础知识有重点地作了回顾。第二章介绍了确定先验分布的若干可供选择的方法。第三章介绍了几类常见统计模型参数的后验分布的主要结果和计算方法。第四章和第五章分别介绍了“贝叶斯统计推断”和“贝叶斯统计决策”的内容。第六章介绍了贝叶斯统计计算的若干方法,包括蒙特卡洛方法和马尔可夫链蒙特卡洛(MCMC)方法以及相关统计软件的简介。本书的每一章附右大量的例题和习题,书末附有常用的几个表格和部分习题解答供读者查用。  大约可在54学时内讲授本书的第1章至第六章的主要内容,教师可根据学时需要选讲本书第1章至第六章的部分内容。书中标“*”号的章节可略去不讲,留给读者作为阅读材料。第六章例题中的R代码和部分例题的数据文件等可从作者个人主页下载。  作者在编写本书的过程中参考了J.O.Berger教授的《统计决策论及贝叶斯分析》和茆诗松教授编写的《贝叶斯统计》等书中的一些内容,以及《贝叶斯分析》一书中由张伟平博士编写的有关贝叶斯统计计算的一些内容。在此表示衷心感谢。  本书编写准备过程中,中国科学技术大学统计与金融系的几个研究生帮助完成了本书部分中文的录入和排版,作者对他们的辛勤工作表示真诚的感谢。高等教育出版社为本书的出版给予了大力支持。在此一并致谢。

uvicorn 与 uvicorn[standard] 的安装说明

摘要:安装Uvicorn时,推荐使用pip install "uvicorn[standard]"以获得完整功能,包括WebSocket支持、自动重载和高性能事件循环。仅安装核心版(pip install uvicorn)适用于快速测试,但缺少关键功能。标准版对FastAPI开发和生产环境至关重要,能显著提升性能并支持WebSocket。除非在资源极度受限的环境,否则都应选择标准安装。可通过python -c "import websockets"等命令验证安装是否完

weixin_69334636的博客 668

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

gunicorn、uwsgi、uvicorn认识

在使用python开发好web程序后,面对一个开机自启动维护的配置的编写,至于使用何组件,我们有三种选择,第一种django使用runserver,貌似支持websocket长连接,对内服务,小组件可以使用;第二、第三就是gunicorn和uwsgi了。但是这两个有什么区别呢?下面从nginx配置入手讲起,感觉需要深入了解认识uwsgi_pass和proxy_pass两个概念(nginx配置)。...

weixin_38392612的博客 5072

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

轻量快速的 Python ASGI 框架 uvicorn

什么是 Uvicorn ? 答:Uvicorn 是基于 uvloop 和 httptools 构建的非常快速的 ASGI 服务器。 什么是 uvloop 和 httptools ? 答: uvloop 用于替换标准库 asyncio 中的事件循环,使用 Cython 实现,它非常快,可以使 asyncio 的速度提高 2-4 倍。asyncio 不用我介绍吧,写异步代码离不开它。 httptools 是 nodejs HTTP 解析器的 Python 实现。 什么是 ASGI 服务..

0x8g1T9E- 3599

用AI快速开发UVICORN应用

实际体验下来,最惊喜的是AI能理解上下文。当询问"如何优化文件上传接口"时,它不仅给出内存管理方案,还主动建议结合前端实现分块上传,这种端到端的思考方式确实提升了开发质量。对于需要快速迭代的项目,这种智能辅助能节省至少40%的编码时间。的AI对话框描述现象,通常都能获得比搜索引擎更精准的解决方案。特别是部署环节,从代码编写到线上服务往往只需点击三次按钮,对个人开发者特别友好。最近在开发一个基于UVICORN的Web应用时,发现传统开发流程中调试和优化环节特别耗时。生成对应的OpenAPI文档注释。

GreyWolf12的博客 730

uvicorn、gunicorn、hypercorn、uwsgi

在 uvicorn 中,worker 不会直接创建新的进程。uvicorn 是一个基于 ASGI(Asynchronous Server Gateway Interface)的 Web 服务器,它使用异步的方式处理请求和响应。uvicorn 启动时,会创建一个主进程,负责监听和接受传入的连接。主进程会在启动时创建指定数量的 worker。每个 worker 都是一个独立的协程或线程,负责处理连接的请求和响应。这些 worker 会在主进程中运行,并与之通信。

CherryXieのblog 3793
上一篇: ISO 及shut_time原理
下一篇: ASGI和AWSIG区别
越甲八千
博客等级 码龄11年 2962粉丝 553原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值