如何在 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 ...

随机推荐

MNIST实例-Tensorflow 初体验
目的还是熟悉这种 tensorflow 框架的基本流程, 即如何导包, 反正我神经网络相关的一些经典理论, BP推导呀, 卷积神经网络呀, 递归神经网络这些的数学原理, 我已经基本推导一遍了, 已基本 ...
K8s新手系列之Pod的基本存储
概念官方文档:https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-volume-storage/ 卷:h ...
GIM: 调用AI自动生成git提交消息的工具
GIM - Git Intelligence Message,是根据文件变更内容,自动请求用户配置的AI服务,生成提交消息的工具. 代码托管地址 https://github.com/davelet/ ...
5个让你眼前一亮的JavaScript装饰器技巧
@charset "UTF-8"; .markdown-body { line-height: 1.75; font-weight: 400; font-size: 15px; o ...
CentOS 7.6 安装JDK 1.8
第一步,下载一个rpm包,下载链接如下 https://www.oracle.com/cn/java/technologies/downloads/ 第二步:上传到服务器中第三步:输入命令进行安装 ...
一文玩转NGINX（对于NGINX，你真的了解吗？）
前言 nginx [engine x] 是一个 HTTP 和反向代理服务器, 邮件代理服务器, 和一个通用的 TCP/UDP 代理服务器, 最初由 Igor Sysoev. 运行了很久在许多负载重的 ...
区块链共识算法--PoW
PoW算法为一种概率算法,其共识结果是临时的,随着时间推移或某种强化,共识结果被推翻的概率越来越小,最终称为事实上结果 1 研究工作量证明(Proof Of Work,简称POW),简单理解就是一份 ...
C#中扩展方法无法获得多态性的行为
在C#中,扩展方法(Extension Methods)是一种用于给现有类型添加新方法的技术.但是,扩展方法无法实现多态性的行为,因为它们是静态方法,它们的行为是在编译时确定的,而不是在运行时. 多态 ...
## 使用C# 6.0中的async/await
异步函数是TPL之上更高级别的抽象,真正简化了异步编程,它与普通函数不一样在于必须有async标识,并且返回类型一般是Task<T>,Task类型,当然也可以使用async void,但更 ...
Median of Two Sorted Arrays---LeetCode进阶路④
题目描述 There are two sorted arrays nums1 and nums2 of size m and n respectively. Find the median of th ...