基于Python的Django QR扫码应用开发问题咨询

核心传输链路梳理 #

先明确两类扫码终端的传输逻辑差异，初期不要上来就做复杂架构，先按场景选对应方案：

• 硬件扫码枪（USB/蓝牙连接的实体扫码设备）：本质是标准HID输入设备，和键盘输入逻辑完全一致，扫码后会自动将二维码解析出的文本内容输入到当前页面聚焦的输入框，绝大多数设备默认在内容末尾追加回车符，不需要写额外的设备对接、数据传输协议，是固定查询场景下成本最低的方案。
• 软扫码终端（手机/平板通过摄像头扫码，包括H5页面、小程序、独立APP）：扫码逻辑在终端本地完成——终端调用摄像头识别解析出二维码文本后，主动发起HTTP/WebSocket请求把文本传给Django后端，后端查库后将匹配结果返回给终端渲染展示。

整个链路没有特殊的黑盒环节，核心流转步骤固定：扫码端解析出二维码文本 -> 文本传输到Django后端 -> 后端拿文本查数据库 -> 返回匹配结果给前端展示。

分步实现参考 #

1. 搭建Django基础框架 #

先建项目、建应用，完成基础配置：

• 先定义数据模型，存储二维码和对应关联信息，在models.py中写入以下代码：

from django.db import models

class QRCodeInfo(models.Model):
    # 存二维码扫出来的原始文本，加唯一约束和索引
    qr_content = models.CharField(max_length=255, unique=True, db_index=True, verbose_name="二维码编码内容")
    # 存需要展示的匹配内容，根据业务可以改字段类型、加关联外键
    match_content = models.TextField(verbose_name="匹配展示内容")
    create_time = models.DateTimeField(auto_now_add=True)

• 执行python manage.py makemigrations、python manage.py migrate完成数据表创建，创建管理员账号后可以直接在Django Admin后台插入几条测试数据，方便后续调试。

2. 按终端类型写对应逻辑 #

场景1：使用硬件扫码枪

不需要单独写API接口，做一个普通的表单查询页面即可：

• 写视图处理查询请求，在views.py中写入：

from django.shortcuts import render
from .models import QRCodeInfo

def qr_query_page(request):
    result = None
    if request.method == "POST":
        qr_text = request.POST.get("qr_content", "").strip()
        if qr_text:
            match_obj = QRCodeInfo.objects.filter(qr_content=qr_text).first()
            result = match_obj.match_content if match_obj else "未查询到该二维码对应信息"
    return render(request, "qr_query.html", {"result": result})

• 配置路由后，写模板文件templates/qr_query.html，核心逻辑是让输入框默认保持聚焦，接收到扫码枪输入的内容后自动提交查询：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>二维码查询</title>
</head>
<body>
    <h1>扫码查询</h1>
    <form method="POST" id="qrForm">
        {% csrf_token %}
        <!-- 输入框设置为透明不可见，保持自动聚焦即可，不需要用户手动点击 -->
        <input type="text" name="qr_content" id="qrInput" autofocus style="position: absolute; opacity: 0;">
    </form>
    <div class="result-box">
        {% if result %}
        <p>{{ result }}</p>
        {% endif %}
    </div>
    <script>
        const inputDom = document.getElementById('qrInput')
        let submitTimer = null
        // 扫码枪输入速度远快于手动输入，监听输入停顿后自动提交
        inputDom.addEventListener('input', () => {
            clearTimeout(submitTimer)
            submitTimer = setTimeout(() => {
                document.getElementById('qrForm').submit()
                // 提交后清空输入框，方便下一次扫码
                inputDom.value = ''
            }, 300)
        })
        // 页面失焦后重新聚焦到输入框，避免用户点到其他地方导致扫码输入无效
        document.addEventListener('click', () => inputDom.focus())
    </script>
</body>
</html>

部署后打开这个页面，插上扫码枪直接扫码就能自动出结果，和超市收银台的扫码逻辑完全一致。

场景2：使用手机/平板软扫码

在上面的页面基础上，额外加一个返回JSON格式的接口即可，供前端扫码后调用：

• 在views.py中追加接口视图：

from django.http import JsonResponse

def qr_query_api(request):
    qr_text = request.GET.get("qr_content", "").strip()
    if not qr_text:
        return JsonResponse({"code": 400, "msg": "缺少二维码参数"})
    match_obj = QRCodeInfo.objects.filter(qr_content=qr_text).first()
    if not match_obj:
        return JsonResponse({"code": 404, "msg": "未查询到对应信息"})
    return JsonResponse({"code": 200, "data": {"content": match_obj.match_content}})

• 前端部分直接调用成熟的H5扫码能力即可，不需要自己从零写摄像头识别逻辑：普通浏览器环境用通用H5扫码组件，微信环境直接调用微信内置的扫码JS接口，识别到二维码文本后，发起请求调用上面的接口，拿到返回结果后直接渲染到页面上即可。注意：浏览器调用摄像头需要HTTPS环境，本地调试用localhost可以正常唤起权限。

初期启动避坑点 #

• 不要一开始就上复杂的加密、签名、自定义传输协议，初期先保证链路跑通，二维码本身存普通字符串即可，后续有防伪造需求再加校验逻辑。
• 硬件扫码枪提前测试默认后缀，绝大多数设备默认带回车后缀，部分老款设备可能带制表符，调整下前端监听的触发逻辑即可兼容。
• 软扫码场景不要自己从零写摄像头识别逻辑，成熟开源组件已经解决了对焦、畸变识别、不同机型适配的问题，重复造轮子很容易卡在兼容性问题上。
• 数据库的qr_content字段一定要加索引，后期数据量上涨后查询速度不会受影响。

内容的提问来源于stack exchange，提问作者Shyrokoa