Django使用signals.py为新建模型实例生成二维码上传S3问题求助

现有代码核心问题 #

• 直接将PIL生成的图像对象赋值给模型的ImageField类型字段，类型不匹配，无法正常存储
• post_save信号回调中再次调用模型save方法未指定更新字段，会循环触发post_save信号，造成逻辑错误
• 仅将二维码存储到本地磁盘，未对接Django的存储系统，无法自动上传到S3

前置配置检查 #

• 确保已经安装依赖：pip install django-storages boto3 qrcode pillow
• 确保settings.py中已经正确配置S3存储后端，示例配置：

# settings.py
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
AWS_ACCESS_KEY_ID = '你的AWS访问密钥ID'
AWS_SECRET_ACCESS_KEY = '你的AWS秘密访问密钥'
AWS_STORAGE_BUCKET_NAME = '你的S3桶名'
AWS_S3_REGION_NAME = '你的桶所在区域，比如ap-northeast-1'
# 可选配置，根据你的需求调整文件访问权限
AWS_DEFAULT_ACL = 'public-read'

• 确保你的inventory模型中qr_code字段为ImageField类型，示例：

# models.py
from django.db import models
class inventory(models.Model):
    # 其余原有字段保持不变
    qr_code = models.ImageField(upload_to='qr_codes/', blank=True, null=True)

修正后的signals.py代码 #

from io import BytesIO
from django.core.files import File
from django.db.models.signals import post_save
from django.dispatch import receiver
import qrcode
# 导入你的inventory模型
from .models import inventory

@receiver(post_save, sender=inventory)
def create_url_qr(sender, instance, created, **kwargs):
    if not created:
        return
    # 生成二维码
    qr = qrcode.QRCode(
        version=1,
        box_size=10,
        border=5
    )
    qr.add_data(f'/MyProperty/item/{instance.id}')
    qr.make(fit=True)
    im = qr.make_image(fill_color="black", back_color="white")
    
    # 将二维码写入内存流，无需保存到本地磁盘
    img_buffer = BytesIO()
    im.save(img_buffer, format='PNG')
    img_buffer.seek(0)
    
    # 封装为Django可识别的File对象，赋值给字段
    file_name = f'qrcode_{instance.id}.png'
    instance.qr_code.save(file_name, File(img_buffer), save=False)
    # 仅更新qr_code字段，避免循环触发post_save信号
    instance.save(update_fields=['qr_code'])

工作原理说明 #

• 二维码生成后直接写入内存缓冲区，不需要在本地磁盘生成临时文件
• 封装为Django的File对象后赋值给ImageField，配合你配置的S3存储后端，Django会自动将文件上传到S3桶的qr_codes/目录下（对应ImageField的upload_to参数）
• 保存时指定update_fields=['qr_code']，仅更新二维码字段，不会触发新一轮的post_save信号，避免循环调用
• 字段中会自动存储S3对应的文件访问路径，不需要额外编写上传逻辑

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