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

在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 %}

? 进阶建议：

• 若需保留被删库存的名称/规格等快照信息（而非仅留空），可改用 on_delete=models.SET() + 自定义函数，将关键字段值固化为字符串；
• 对已有数据，可编写数据迁移脚本，将当前活跃库存 ID 映射为 NULL 或存档标识，确保过渡平滑；
• 永远避免 DO_NOTHING（需数据库层手动约束支持，Django 不校验，极易导致数据不一致）。

综上，SET_NULL 是兼顾数据安全、可维护性与用户体验的最佳实践——它让删除操作成为一次“逻辑归档”，而非危险的数据清除。

以上就是《安全删除Django库存项不损历史数据》的详细内容，更多关于的资料请关注golang学习网公众号！