在 Django CRM 系统中，直接删除被估计单、服务报告或发票引用的库存项会导致外键关联断裂，引发页面加载失败；正确做法是通过 on_delete 参数配置外键行为（如 SET_NULL），使历史记录保留完整性，同时逻辑上“下架”该库存项。
在 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)⚠️ 实施前必须完成以下步骤：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- 在数据库迁移前，确保目标外键字段已添加 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 是兼顾数据安全、可维护性与用户体验的最佳实践——它让删除操作成为一次“逻辑归档”，而非危险的数据清除。
