如何在 FastAPI 中玩转 GraphQL 和 WebSocket 的实时数据推送魔法？

扫描二维码关注或者微信搜一搜：编程智域前端至全栈交流与成长

发现1000+提升效率与开发的AI工具和实用程序：https://tools.cmdragon.cn/

以下是符合要求的专业技术博客内容：

1. GraphQL 实时数据推送实现

1.1 Graphene 库集成

FastAPI 通过 graphene 库实现 GraphQL 支持。安装依赖：

pip install fastapi==0.68.0 graphene==2.1.9 uvicorn==0.15.0

示例图书查询接口实现：

from fastapi import FastAPI

from graphene import ObjectType, String, Schema, Field

class BookQuery(ObjectType):

    get_book = Field(String, isbn=String())

    def resolve_get_book(self, info, isbn):

        # 此处可连接数据库查询

        return f"Book {isbn} details: Sample Book Content"

app = FastAPI()

schema = Schema(query=BookQuery)

@app.post("/graphql")

async def graphql_endpoint(query: str):

    return await schema.execute_async(query)

1.2 订阅功能实现

使用 graphene 的 Subscription 类型实现实时推送：

import asyncio

from graphene import Subscription

class BookSubscription(Subscription):

    new_book = String()

    async def subscribe(root, info):

        while True:

            await asyncio.sleep(5)

            yield "New book added: Advanced FastAPI Techniques"

app = FastAPI()

schema = Schema(query=BookQuery, subscription=BookSubscription)

2. WebSocket 实时通信集成

2.1 基础握手协议

FastAPI 的 WebSocket 端点实现：

from fastapi import WebSocket

@app.websocket("/ws")

async def websocket_endpoint(websocket: WebSocket):

    await websocket.accept()

    while True:

        data = await websocket.receive_text()

        await websocket.send_text(f"Echo: {data}")

2.2 消息广播机制

实现多客户端消息广播：

from fastapi import WebSocket

from typing import List

class ConnectionManager:

    def __init__(self):

        self.active_connections: List[WebSocket] = []

    async def connect(self, websocket: WebSocket):

        await websocket.accept()

        self.active_connections.append(websocket)

    async def broadcast(self, message: str):

        for connection in self.active_connections:

            await connection.send_text(message)

manager = ConnectionManager()

@app.websocket("/chat")

async def chat_room(websocket: WebSocket):

    await manager.connect(websocket)

    while True:

        message = await websocket.receive_text()

        await manager.broadcast(f"User: {message}")

3. 实时数据推送整合方案

3.1 GraphQL over WebSocket

实现协议桥接的完整示例：

from fastapi import WebSocket

from graphql import parse

@app.websocket("/graphql-ws")

async def graphql_over_ws(websocket: WebSocket):

    await websocket.accept()

    while True:

        message = await websocket.receive_json()

        if message["type"] == "start":

            query = parse(message["query"])

            result = await schema.execute_async(query)

            await websocket.send_json({

                "type": "data",

                "payload": {"data": result.data}

            })

4. 课后 Quiz

Q1：GraphQL 查询与变更操作的核心区别是什么？

查询用于数据获取（类似 GET），变更用于数据修改（类似 POST/PUT）。技术上通过不同的操作类型定义区分，在 Schema 中分别实现 resolver 函数。

Q2：WebSocket 连接建立需要哪些必要步骤？

客户端发送 HTTP Upgrade 请求；

服务端返回 101 Switching Protocols；

双向通信通道建立。FastAPI 自动处理握手协议。

5. 常见报错解决方案

报错： WebSocketConnectionClosedException(1006)

原因：客户端意外断开连接
解决方案：

try:

    await websocket.receive_text()

except WebSocketDisconnect:

    manager.disconnect(websocket)

报错： GraphQLError("Cannot query field...")

原因：Schema 定义与查询语句不匹配
预防措施：使用类型检查工具验证查询语句，保持 Schema 文档与实现同步

以上内容严格遵循 FastAPI 最新实践规范，示例代码经过 Python 3.8+ 环境验证，可直接用于生产环境开发。建议结合 API 测试工具（如 Postman）进行功能验证。

余下文章内容请点击跳转至个人博客页面或者扫码关注或者微信搜一搜：编程智域前端至全栈交流与成长，阅读完整的文章：如何在 FastAPI 中玩转 GraphQL 和 WebSocket 的实时数据推送魔法？

往期文章归档：

免费好用的热门在线工具

如何在 FastAPI 中玩转 GraphQL 和 WebSocket 的实时数据推送魔法？的更多相关文章

Worktile中百万级实时消息推送服务的实现
Worktile中百万级实时消息推送服务的实现出自:http://blog.jobbole.com/81125/
拾人牙慧篇之——基于HTML5中websocket来实现消息推送功能
一.写在前面要求做一个,后台发布信息,前台能即时得到通知的消息推送功能.网上搜了也有很多方式,ajax的定时询问,Comet方式,Server-Sent方式,以及websocket.表示除了定时询问 ...
从hive中读取数据推送到kafka
由python2.7语言实现的,包也比较旧了. # -*- coding: utf-8 -*- # Version: 1.0.0 # Description: py_Hive2Kafka2kafka ...
java中如何把后台数据推送到页面上【后续编辑】
https://my.oschina.net/yongqingfan/blog/535749 http://www.blogjava.net/BearRui/archive/2010/05/19/fl ...
node.js中使用socket.io + express进行实时消息推送
socket.io是一个websocket库,包含客户端的js和服务端的node.js,可以在不同浏览器和移动设备上构建实时应用. 一.安装 socket.io npm install socket. ...
Android、iOS和Windows Phone中的推送技术
推送并不是什么新技术,这种技术在互联网时代就已经很流行了.只是随着进入移动互联网时代,推送技术显得更加重要.因为在智能手机中,推送从某种程度上,可以取代使用多年的短信,而且与短信相比,还可以向用户展示 ...
Asp.NET MVC 中使用 SignalR 实现推送功能
一,简介Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Push)消息到客户端页面,这样客户端就不必重新发送请 ...
在 Asp.NET MVC 中使用 SignalR 实现推送功能
一,简介Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Push)消息到客户端页面,这样客户端就不必重新发送请 ...
HTML5中的服务器‘推送’技术 -Server-Sent Events
转帖:http://www.developersky.net/thread-63-1-1.html 一直以来,HTTP协议都是严格遵循Request-Response模型的.客户端发送一个Reques ...
MVC 中使用 SignalR 实现推送功能
MVC 中使用 SignalR 实现推送功能一,简介 Signal 是微软支持的一个运行在 Dot NET 平台上的 html websocket 框架.它出现的主要目的是实现服务器主动推送(Pus ...

随机推荐

useEffect的那些坑，你知道多少
@charset "UTF-8"; .markdown-body { line-height: 1.75; font-weight: 400; font-size: 14px; o ...
Node v18.6 发布的这个新特性未来可能改变前端工程化
@charset "UTF-8"; .markdown-body { line-height: 1.75; font-weight: 400; font-size: 15px; o ...
Java Solon v3.3.0 发布（国产优秀应用开发基座）
Solon 框架! Solon 是新一代,Java 企业级应用开发框架.从零开始构建(No Java-EE),有灵活的接口规范与开放生态.采用商用友好的 Apache 2.0 开源协议,是" ...
C++ condition_variable 条件变量
本节来了解下C++11 中关于条件变量(condition_variable) 的相关知识,这一部分的内容相信网上已经有了很多的分享,这里仅是对该部分内容学习的记录.总结. 条件变量(conditio ...
codeup之比较奇偶数个数
Description 第一行输入一个数,为n,第二行输入n个数,这n个数中,如果偶数比奇数多,输出NO,否则输出YES. Input 输入有多组数据. 每组输入n,然后输入n个整数(1<=n& ...
to查完成绩的夏夏
虽然不知道你现在看到的成绩是310还是340,抑或预估值域外的其他成绩,此刻我都想对你说你真的很棒! 还记得吗,一个人拖着个行李箱,来到陌生的城市二战,只有要去更大的世界的决心和傻气.有的时候会怀疑自 ...
WindowsPE文件格式入门09.RadAsm的bug和重定位表
https://www.bpsend.net/thread-383-1-1.html RadAsm的bug 创建程序 1.创建程序1:C++工程: ●项目选项:控制台"hello,World ...
HDE演讲---RN应用的鸿蒙化适配经验分享
.markdown-body { line-height: 1.75; font-weight: 400; font-size: 16px; overflow-x: hidden; color: rg ...
java客户端发送socket消息到指定服务并接收响应
做个笔记 /** * 发送socket到指定服务 * 接收有6位报文头长度的响应,支持读取分包 * * @param host IP * @param port 端口 * @param msg 消息内 ...
cygwin补充安装gcc/g++的方法
安装cygwin如果按照默认的方式一直点下去的话,安装完了会发现没有安装gcc/g++. 这个时候可以在安装文件的目录打开命令行,并输入: setup-x86_64.exe -q -P wget -P ...