当前位置：首页 > 文章列表 > 文章 > python教程 > 安全删除Django库存项不损历史数据

安全删除Django库存项不损历史数据

2026-05-27 10:49:48 0浏览收藏

在Django CRM系统中，直接删除被业务单据引用的库存项会破坏外键关联、导致页面崩溃，而通过合理配置`on_delete=models.SET_NULL`（配合`null=True`和`is_active`状态字段），既能安全“下架”库存项、避免历史数据丢失，又能保障报表完整性与前端健壮性——这不仅是技术上的最佳实践，更是一次让删除操作从高危操作转变为可控归档的关键升级。

在 Django CRM 系统中，直接删除被估计单、服务报告或发票引用的库存项会导致外键关联断裂，引发页面加载失败；正确做法是通过 `on_delete` 参数配置外键行为（如 `SET_NULL`），使历史记录保留完整性，同时逻辑上“下架”该库存项。

在 Django 中，库存项（InventoryItem）通常通过 ForeignKey 被其他模型（如 EstimateItem、ServiceReportItem 或 InvoiceLine）引用。默认使用 models.CASCADE 时，一旦删除库存项，所有关联记录将被级联删除——这显然不可取；而若使用 models.PROTECT，则根本无法删除，违背业务灵活性。

✅ 推荐方案：使用 on_delete=models.SET_NULL
该策略既保留历史报告的完整性，又实现库存项的“软性归档”。前提是对应外键字段允许为空（null=True, blank=True）：

# models.py
from django.db import models

class InventoryItem(models.Model):
    name = models.CharField(max_length=100)
    sku = models.CharField(max_length=50, unique=True)
    is_active = models.BooleanField(default=True)  # 新增状态字段，便于前端过滤

    def __str__(self):
        return self.name

class EstimateItem(models.Model):
    estimate = models.ForeignKey('Estimate', on_delete=models.CASCADE)
    inventory_item = models.ForeignKey(
        InventoryItem,
        on_delete=models.SET_NULL,  # 关键：删除库存项时设为 NULL
        null=True,
        blank=True,
        related_name='estimate_items'
    )
    quantity = models.PositiveIntegerField()
    unit_price = models.DecimalField(max_digits=10, decimal_places=2)

⚠️ 实施前必须完成以下步骤：

在数据库迁移前，确保目标外键字段已添加 null=True（否则 SET_NULL 会触发 IntegrityError）；
运行迁移：python manage.py makemigrations && python manage.py migrate；
（可选但强烈建议）为 InventoryItem 添加 is_active 字段，并在管理后台/列表页隐藏已停用项，避免误操作；
前端模板中需容错处理：例如显示 "已下架商品（SKU: ABC123）" 而非直接访问 item.inventory_item.name（防止 None 引发 AttributeError）：

<!-- 示例模板片段 -->
{% if item.inventory_item %}
    {{ item.inventory_item.name }} ({{ item.inventory_item.sku }})
{% else %}
    <span class="text-muted">[已下架商品]</span>
{% endif %}

? 进阶建议：