Django Admin模型save方法中如何使用select_related正常保存数据

核心问题根源 #

select_related是Django ORM 查询阶段的性能优化方法，仅作用于QuerySet查询集，作用是预加载外键关联数据减少N+1查询，本身不承担数据写入、关联实例更新的能力。无法保存计算值的问题本质是混淆了查询优化方法和数据持久化逻辑，常见错误场景包括：

• 对单个已实例化的模型对象调用select_related，该方法对单个实例完全无效
• 计算完库存差值后，没有调用关联模型实例的save()方法，改动只存在内存中不会落库
• 把库存冗余存储在出库单表，没有更新库存台账表的源数据，导致数据不一致

正确实现方案 #

假设模型关系为：StockOut（出库单）通过外键字段stock关联StockList（库存台账），需要在新建出库单时扣减对应商品的库存数量，推荐将逻辑收敛在模型层实现：

# models.py
from django.db import models
from django.db import transaction

class StockList(models.Model):
    # 原有字段定义
    product_quantity = models.IntegerField(verbose_name="当前库存数量")
    # 其余商品字段省略

class StockOut(models.Model):
    stock = models.ForeignKey(StockList, on_delete=models.CASCADE, verbose_name="关联库存商品")
    shipping_qty = models.IntegerField(verbose_name="出库数量")
    # 其余出库单字段省略

    def save(self, *args, **kwargs):
        # 标记是否为新建实例，避免修改历史出库单重复扣减库存
        is_new_instance = self._state.adding
        
        # 开启事务保证数据一致性，避免并发超卖
        with transaction.atomic():
            super().save(*args, **kwargs)
            
            if is_new_instance:
                # 单个实例直接通过外键属性取关联对象即可，不需要调用select_related
                related_stock = self.stock
                # 扣减库存
                related_stock.product_quantity -= self.shipping_qty
                # 库存合法性校验
                if related_stock.product_quantity < 0:
                    raise ValueError("库存不足，无法完成出库操作")
                # 关键：必须调用关联实例的save方法，改动才会写入数据库
                related_stock.save(update_fields=["product_quantity"])

select_related的正确使用场景 #

select_related仅在批量查询QuerySet时使用，用来优化查询性能，和保存逻辑无关，比如在admin列表页预加载关联数据避免重复查库：

# admin.py
from django.contrib import admin
from .models import StockOut, StockList

class StockOutAdmin(admin.ModelAdmin):
    # 列表页预加载关联库存数据，减少SQL查询次数
    list_select_related = ["stock"]
    list_display = ["id", "stock", "shipping_qty"]

admin.site.register(StockOut, StockOutAdmin)
admin.site.register(StockList)

关键注意事项 #

• 不要在单个模型实例的save方法里调用select_related，该方法是QuerySet的内置方法，对单个实例无意义，直接通过外键字段即可获取关联对象
• 所有对模型字段的修改，必须调用对应实例的save()方法才会持久化到数据库，指定update_fields参数可以只更新改动字段，提升写入效率
• 库存类计算逻辑必须加事务锁，避免并发请求导致库存数据错乱
• 剩余库存的唯一数据源应该保存在StockList台账表，不要冗余存储在StockOut出库单表，避免多源数据不一致

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