在Django项目中集成MQTT客户端的完整指南

陆景行
陆景行
发布时间:2026-10-15 | 5人浏览过
原创

本文详细介绍如何在Django项目中集成MQTT客户端。内容涵盖paho-mqtt库的安装、Python MQTT脚本的编写(包括连接、订阅与消息处理),以及如何在Django 2.1+版本中通过wsgi.py启动独立线程运行MQTT服务,确保不阻塞主进程。

安装MQTT

在Python环境中集成MQTT支持非常便捷,关键在于确保执行命令准确无误。在Python 3环境下,安装Python MQTT客户端库的命令如下:


pip3 install paho-mqtt

使用Python MQTT

编写Python MQTT脚本时,需特别注意Django ORM的调用环境配置。具体实现代码如下:


# 为了能在外部脚本中调用Django ORM模型,必须配置脚本环境变量,将脚本注册到Django的环境变量中
import os, sys
import django
# 第一个参数固定,第二个参数是工程名称.settings
os.environ.setdefault('DJANGO_SETTING_MODULE', 'my_django.settings')
django.setup()

# 引入mqtt包
import paho.mqtt.client as mqtt
# 使用独立线程运行
from threading import Thread
from app名 import models
import time
import json

# 建立mqtt连接
def on_connect(client, userdata, flag, rc):
    print("Connect with the result code " + str(rc))
    client.subscribe('test/#', qos=2)

# 接收、处理mqtt消息
def on_message(client, userdata, msg):
    out = str(msg.payload.decode('utf-8'))
    print(msg.topic)
    print(out)
    out = json.loads(out)

    # 收到消息后执行任务
    if msg.topic == 'test/newdata':
        print(out)

# mqtt客户端启动函数
def mqttfunction():
    global client
    # 使用loop_start 可以避免阻塞Django进程,使用loop_forever()可能会阻塞系统进程
    # client.loop_start()
    # client.loop_forever() 有掉线重连功能
    client.loop_forever(retry_first_connection=True)

client = mqtt.Client(client_id="test", clean_session=False)

# 启动函数
def mqtt_run():
    client.on_connect = on_connect
    client.on_message = on_message
    # 绑定 MQTT 服务器地址
    broker = '192.168.1.88'
    # MQTT服务器的端口号
    client.connect(broker, 1883, 62)
    client.username_pw_set('user', 'user')
    client.reconnect_delay_set(min_delay=1, max_delay=2000)
    # 启动
    mqttthread = Thread(target=mqttfunction)
    mqttthread.start()

# 启动 MQTT
# mqtt_run()

if __name__ == "__main__":
    mqtt_run()

在Django项目中启动脚本

针对Django 2.1及以上版本,只需在wsgi.py文件中引入目标脚本模块,并调用其启动函数即可实现后台运行。示例代码如下:


from 存放MQTT脚本的模块 import 脚本名
# 假如脚本名是:mqtt_functions
mqtt_functions.mqtt_run()

至此,关于在Django中集成MQTT的方法介绍完毕。如需了解更多Django与MQTT结合的应用案例,建议查阅本站往期文章或继续浏览后续相关内容,感谢大家的支持!

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表