Django-Channels聊天室

最新推荐文章于 2025-07-04 09:58:53 发布
最新推荐文章于 2025-07-04 09:58:53 发布
阅读量2.8k 收藏 25
点赞数 8
CC 4.0 BY-SA版权
分类专栏： django 文章标签： websocket django
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43681877/article/details/109383449
本文介绍如何使用WebSocket技术实现多人在线聊天室。从原理出发，详细解释WebSocket连接机制，并通过Django框架进行代码实战，包括环境搭建、配置及消费者逻辑处理。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

讲解路线：聊天室原理——>多人聊天——>房间活动——>点对点聊天——>消息推送

一、聊天室原理

即时通讯在如今已经十分常见，大到QQ、微信，小到网站客服，这其实是同一个“聊天室”原理。聊天室采用WebSocket技术，下面来聊一聊WebSocket技术。

1. WebSocket原理

与http连接不同，websocket是长连接，一次握手即可传输消息，每个连接有一个唯一的身份标识
在这里插入图片描述

2. 多人聊天原理

多人聊天则是通过groupid将一个个的连接进行分组。客户端要发送聊天信息给服务器端，服务器在和该客户端同一组的组内进行消息广播，这样，每个连接都能接收到消息。
在这里插入图片描述

点对点聊天原理

相当于这两个人是一组

消息推送

相当于一个人一组，这同时也使用于特殊定制通知服务。

二、代码实战

教材 https://channels.readthedocs.io/en/stable/introduction.html

django 同时支持http和websocket请求，只不过涉及到的配置文件不同

1. 安装

python -m pip install -U channels

2. 在Django中注册channels

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'channels',
]

3. 使用asgi服务器与wsgi服务器

asgi.py

import os
from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'GameDesc.settings')
application = get_asgi_application()

wsgi.py

import os
from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'GameDesc.settings')
application = get_wsgi_application()

4. 新启项目Room并进行配置

4.1 新建项目
python3 manage.py startapp Room
4.2 配置settings
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'channels',
    'Room',
]
4.3 新建文件夹customers和routings.py

views文件夹下为http类型接口处理的视图函数，customers文件夹下处理websocket请求
urls.py为http类型的路由，routings为websocket类型的路由
在这里插入图片描述

6. 添加总路由

在项目文件夹（有settings的文件夹）下新建routings.py，作为总路由
routings.py

from channels.auth import AuthMiddlewareStack
from channels.routing import ProtocolTypeRouter, URLRouter
import Room.routing

application = ProtocolTypeRouter({
    # (http->django views is added by default)
    'websocket': AuthMiddlewareStack(
        URLRouter(
            Room.routing.websocket_urlpatterns
        )
    ),
})

7. 设置关于channels的settings

目录结构
在这里插入图片描述

# Channels
ASGI_APPLICATION = 'GameDesc.routing.application'
CHANNEL_LAYERS = {
    'default': {
        'BACKEND': 'channels_redis.core.RedisChannelLayer',
        'CONFIG': {
            "hosts": [('127.0.0.1', 6379)],
        },
    },
}

8. 创建视图文件

8.1 预备知识1

基本的customers结构（同步）

# chat/consumers.py
import json
from asgiref.sync import async_to_sync
from channels.generic.websocket import WebsocketConsumer

class ChatConsumer(WebsocketConsumer):
	
	# 建立连接
    def connect(self):
        self.room_name = self.scope['url_route']['kwargs']['room_name']
        self.room_group_name = 'chat_%s' % self.room_name

        # Join room group
        async_to_sync(self.channel_layer.group_add)(
            self.room_group_name,
            self.channel_name
        )
        
		# 接受连接，不接收不连接
        self.accept()
	
	# 断开连接
    def disconnect(self, close_code):
        # Leave room group
        async_to_sync(self.channel_layer.group_discard)(
            self.room_group_name,
            self.channel_name
        )

    # Receive message from WebSocket 从客户端发送的包中获取消息
    def receive(self, text_data):
        text_data_json = json.loads(text_data)
        
        # 从包中获取消息，前端的字段为message
        message = text_data_json['message']

        # Send message to room group 将要广播的消息添加至包中，字段为message
        async_to_sync(self.channel_layer.group_send)(
            self.room_group_name,
            {
                'type': 'chat_message',
                'message': message
            }
        )

    # Receive message from room group  
    def chat_message(self, event):
        message = event['message']

        # Send message to WebSocket 发送到ws连接中
        self.send(text_data=json.dumps({
            'message': message
        }))
8.2 预备知识2

基本的customers结构（异步），和同步一样

import json
from channels.generic.websocket import AsyncWebsocketConsumer

class ChatConsumer(AsyncWebsocketConsumer):
    async def connect(self):
        self.room_name = self.scope['url_route']['kwargs']['room_name']
        self.room_group_name = 'chat_%s' % self.room_name

        # Join room group
        await self.channel_layer.group_add(
            self.room_group_name,
            self.channel_name
        )

        await self.accept()

    async def disconnect(self, close_code):
        # Leave room group
        await self.channel_layer.group_discard(
            self.room_group_name,
            self.channel_name
        )

    # Receive message from WebSocket
    async def receive(self, text_data):
        text_data_json = json.loads(text_data)
        message = text_data_json['message']

        # Send message to room group
        await self.channel_layer.group_send(
            self.room_group_name,
            {
                'type': 'chat_message',
                'message': message
            }
        )

    # Receive message from room group
    async def chat_message(self, event):
        message = event['message']

        # Send message to WebSocket
        await self.send(text_data=json.dumps({
            'message': message
        }))
8.3 代码实战

回到customers文件夹下，创建ChatCustomers.py

8.3.1 说明：

（1）由于是教学版，故省略较多逻辑检查
（2）项目需要，故返回了历史聊天记录，但是实际上是不需要储存聊天记录的，就像加入QQ群聊，只能获取加入之后的消息，是不会获取到加入之前的聊天记录的
（3）这一环节没有涉及到mysql等关系型数据库的操作，故可以使用异步提高效率，但是涉及到对mysql数据库增删改查等操作时，不能使用异步，只能使用同步，否则会报错（亲测）

8.3.2 ChatCustomers.py

有了上面的知识，相信你一定可以看明白啦

from GameDesc.settings import MAX_REDIS_SAVE_TIME
from channels.generic.websocket import AsyncWebsocketConsumer
from GameDesc.redis_tools.redis_message import redis_get_room_message, redis_save_room_message # 此处是redis存储消息，是为了获取历史消息，可以不管
import json
import datetime
import time


# 进入房间后即可点击加入聊天室  注意检查用户是否登录
class RoomChatConsumer(AsyncWebsocketConsumer):
    async def connect(self):
        self.room_id = self.scope['url_route']['kwargs']['room_id'] # 获取传输的房间Id
        self.user_id = self.scope['url_route']['kwargs']['user_id']  # 获取传输的user_id
        self.room_group_name = 'chat_%s' % self.room_id  # 添加分组名以chat_开头
        # Join room chat group
        await self.channel_layer.group_add(
            self.room_group_name,  # 房间号标识 用于分组
            self.channel_name,  # 个人标识
        )
        await self.accept()
        # 发送加入房间消息并且获取历史聊天记录
        flag, old_messages = redis_get_room_message(room_group_name=self.room_group_name)
        if flag == False:
            message = {
                "_id": '2',
                "groupId": self.room_id,
                "nickName": self.user_id, 
                "avatarUrl": "",
                "textContent": "未获得历史消息",
                "user_id": "oKYr74nbN8kRyqZZXGAHb-0xWuzQ1",  # user_id
                "sendTime": time.ctime(),
                "sendTimeTS": time.ctime()
            }
            old_messages.append(message)
        else:
            message = {
                "_id": '1',
                "groupId": self.room_id,
                "nickName": self.user_id,
                "avatarUrl": "",
                "textContent": "{0} 已加入聊天室...".format(self.user_id),
                "user_id": "oKYr74nbN8kRyqZZXGAHb-0xWuzQ1",
                "sendTime": time.ctime(),
                "sendTimeTS": time.ctime()
            }
            old_messages.append(message)
        await self.channel_layer.group_send(
            self.room_group_name,
            {
                'type': 'chat_message',
                'message': old_messages  # 把发送的信息放到event['message']字段里面 ,返回所有信息，数组形式
            }
        )

    async def disconnect(self, close_code):
        self.room_id = self.scope['url_route']['kwargs']['room_id']
        self.user_id = self.scope['url_route']['kwargs']['user_id']
        # 退出聊天室向组内所有人广播
        message = {
            "_id": '0',
            "groupId": self.room_id,
            "nickName": self.user_id,  
            "avatarUrl": "",
            "textContent": "{0} 已退出聊天室...".format(self.user_id),
            "user_id": "oKYr74nbN8kRyqZZXGAHb-0xWuzQ1",
            "sendTime": time.ctime(),
            "sendTimeTS": time.ctime()
        }
        await self.channel_layer.group_send(
            self.room_group_name,
            {
                'type': 'chat_message',
                'message': message  # 把发送的信息放到event['message']字段里面
            }
        )
        # Leave room group
        await self.channel_layer.group_discard(
            self.room_group_name,
            self.channel_name
        )

    # Receive message from WebSocket
    async def receive(self, text_data):
        text_data_json = json.loads(text_data)
        message = text_data_json['message']
        redis_save_room_message(self.room_group_name, message, MAX_REDIS_SAVE_TIME)  # 时间暂定
        # Send message to room group
        await self.channel_layer.group_send(
            self.room_group_name,
            {
                'type': 'chat_message',
                'message': message,  # 把发送的信息放到event['message']字段里面
            }
        )

    # Receive message from room group
    async def chat_message(self, event):
        message = event['message']
        # Send message to WebSocket 将前面函数返回的消息发送到ws连接上
        await self.send(text_data=json.dumps({
            'message': message,
        }))
Django channel 使用说明 -- 以聊天室为例(1)
shiter编写程序的艺术
11-07 589
本教程是为Channels 4.0编写的，它支持Python 3.7+和Django3.2+.
使用 Django Channels 构建实时聊天应用（包含用户认证和消息持久化）
Code掘金的博客
05-31 1666
Django Channels 是 Django 的一个扩展，允许在 Web 应用中添加实时功能，例如 Websockets、HTTP2 和其他协议。本文将介绍如何使用 Django Channels 构建一个简单的实时聊天应用程序。通过使用 Django Channels，你可以很容易地在 Django 中添加实时功能，为你的应用程序提供更好的用户体验。你可以扩展这个简单的示例，添加更多功能，例如用户认证、消息持久化等。创建一个新的 ASGI 路由文件。现在，你可以通过访问。
Django利用Channels+websocket开发聊天室
Aiwin的博客
06-23 2707
Django利用Channels+websocket开发聊天室的详细教程
Django Channels WebSocket实时通信实战：从聊天功能到消息推送
最新发布
高压锅博客
07-04 781
本文介绍了使用Django Channels构建WebSocket实时应用的方法。通过对比传统HTTP与WebSocket协议，分析了WebSocket在实时通信中的优势。详细讲解了Django Channels的技术架构，包括ASGI协议服务器、频道层和消费者三个核心组件。文章提供了完整的环境配置指南，从Python版本、Django安装到Redis消息队列的设置。在实现部分，展示了前后端WebSocket通信的关键代码：前端通过JavaScript建立WebSocket连接并处理消息推送；后端配置路由和
一文掌握Django实时聊天室开发（Channels+Bootstrap，内含完整代码）
大家好，我是阿彬，专注于机器视觉中的细节之美与技术之道
11-15 1673
使用django5打造实时聊天室
Python django4.0实现简易聊天室（channels、channels-redis）
08-02
channels-redis有redis环境依赖，需要提前安装redis环境且版本>=5.0（可百度安装教程） python环境3.8、以及虚拟环境安装自行安装（建议安装虚拟环境） 有虚拟环境进入虚拟环境执行如下命令： pip install -r requirements.txt 进入项目目录wschat 修改wschat/settings.py 136行redis地址 修改app01/templates/index.html 49行 websocket修改地址。改为127.0.0.1只能是本机进行消息的发送。改为本机IP，局域网内也可以进行发送 启动环境 python.exe manage.py runserver 0.0.0.0:8000 访问地址 http://127.0.0.1:8000/index/ 如有问题随时联系
real-Time-Chat-Django-channels
05-18
Django Channels是Django框架的一个扩展，它允许我们处理非HTTP协议的通信，如WebSocket，从而实现实时交互的功能，例如聊天室、实时通知等。在Python编程环境下，Django Channels为我们提供了一个强大的工具集，...
Python库 django-channels-presence 的安装与应用
通过Channels，开发者可以将Django应用转换为实时应用，如聊天室、实时投票系统等。 存在性感知（Presence）是一种技术，主要用于实时应用，如聊天室、在线游戏等。存在性感知可以让应用知道哪些用户是在线的，哪些...
Python库django-channels-handlers-0.2.0发布
这种机制特别适用于开发需要实时数据交换的应用，如聊天室、游戏和实时通知等。 4. WebSockets WebSocket 是一种在单个TCP连接上进行全双工通讯的协议。它允许服务器主动地向客户端推送消息。由于其持久的连接方式...
探索 Django Channels Chat：实时聊天应用的新时代
gitblog_00012的博客
04-14 604
探索 Django Channels Chat：实时聊天应用的新时代 django-channels-chatA simple Django-Channels web chat!项目地址:https://gitcode.com/gh_mirrors/dj/django-channels-chat 是一个基于 Django 框架和 Channels 扩展开发的实时聊天应用项目。它将传统的 HTTP...
基于django+channels完成即时通信聊天室
m0_53091125的博客
07-18 725
一开始使用django+channels开项目的时候没有注意版本兼容的问题，两个都使用了最高版本。报错是not found xxxx，就是ws://127.0.0.1:8000/room/123访问都是404报错！启动项的时候并没有提到启动了channels，这里就很不对劲！当然你也试着全局修改django和channels的版本，如下，双击django打开。至于其他搭配是否兼容博主就不知道了，可以去搜搜看django和channels可以兼容的搭配，不想找的可以参考这个。
Django Channels 实现点对点实时聊天和消息推送功能
01-20
简介在很多实际的项目开发中，我们需要实现很多实时功能；而在这篇文章中，我们就利用django channels简单地实现了点对点聊天和消息推送功能。 手边有一个项目需要用到后台消息推送和用户之间一对一在线聊天的功能。例如用户A评论了用户B的帖子，这时候用户B就应该收到一条通知，显示自己的帖子被评论了。这个功能可以由最基本的刷新页面后访问数据库来完成，但是这样会增加对后台服务器的压力，同时如果是手机客户端的话，也会造成流量的损失。于是，我们考虑使用websocket建立一个连接来完成这个功能。 但是django并不支持websocket，因此在一番寻找之后发现了django-channels这
基于django channel实现websocket的聊天室的方法示例
09-19
主要介绍了基于基于django channel实现websocket的聊天室的方法示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
Django Channels Chat 项目教程
gitblog_01133的博客
09-13 846
Django Channels Chat 项目教程 项目介绍 Django Channels Chat 是一个基于 Django 框架构建的小型功能性点对点消息中心应用。该项目利用 Django Channels 实现了 WebSocket 通信，避免了客户端的轮询机制，从而提高了消息传递的实时性。应用还提供了一个 REST API，用于处理消息的存储和检索。 项目快速启动 环境准备 Pytho...
django channels(websocket)的使用，实现网页间实时聊天
分享一点有用的知识
04-18 2152
django channels(websocket)的使用，实现网页间实时聊天
基于Python+Django框架的多人在线聊天程序
毕业作品网站
09-10 1999
本项目的选题为项目六：聊天程序，具体项目任务如下所示：经过开发，本项目最终实现了项目任务 2. 的大体功能，实现了多用户之间的在线聊天室。
Python+django网页设计入门（20）：使用WebSocket创建多人在线聊天室
董付国的Python专栏
03-09 477
2019年3月8日-10日公众号送书活动：中小学生Python课应该学什么================前导课程：Python+django网页设计入门（19）：创建新模型扩展自带用户表...
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

杰西啊杰西

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值