在 Django 应用中，直接删除被外键引用的库存项会导致关联的报价单、服务报告和发票加载失败；正确做法是修改 ForeignKey 的 on_delete 行为（如设为 SET_NULL），使历史记录保留但解除强绑定。
在 django 应用中，直接删除被外键引用的库存项会导致关联的报价单、服务报告和发票加载失败；正确做法是修改 foreignkey 的 `on_delete` 行为（如设为 `set_null`），使历史记录保留但解除强绑定。
在 Django Web 应用中，库存项（InventoryItem）被多个业务模型（如 Estimate、ServiceReport、Invoice）通过 ForeignKey 关联时，若使用默认的 on_delete=models.CASCADE 或未显式指定行为，删除库存项将导致数据库级约束冲突或查询时因外键失效而抛出 DoesNotExist 异常——这正是您遇到“报表无法加载”的根本原因。
✅ 推荐解决方案：改用 SET_NULL 保持历史完整性
最符合业务逻辑的做法是：允许删除库存项，但保留已有报表数据的可读性。此时应将外键字段的 on_delete 参数设为 models.SET_NULL，并确保该字段允许为空：
# 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)
# 其他字段...
class Estimate(models.Model):
customer = models.CharField(max_length=100)
# 其他字段...
inventory_item = models.ForeignKey(
InventoryItem,
on_delete=models.SET_NULL, # ← 关键修改
null=True, # ← 必须设为 True
blank=True,
related_name='estimates'
)
# 同理更新 ServiceReport 和 Invoice 模型中的对应外键字段
⚠️ 注意事项：
- 修改模型后需执行 python manage.py makemigrations 和 python manage.py migrate；
- 若数据库中已有非空外键数据，迁移可能失败；可先添加 null=True 迁移，再手动处理或使用 --fake-initial（谨慎操作）；
- 模板或视图中需兼容 inventory_item 可能为 None 的情况，例如：
{% if estimate.inventory_item %} {{ estimate.inventory_item.name }} {% else %} [已下架库存项] {% endif %}
? 其他 on_delete 策略对比（按推荐度排序）
| 策略 | 适用场景 | 风险提示 |
|---|---|---|
| SET_NULL | ✅ 历史报表需保留且显示“已删除”状态 | 字段必须 null=True |
| PROTECT | ❌ 禁止删除（适合核心不可删资源） | 删除库存时直接报错，不解决您的需求 |
| CASCADE | ❌ 连带删除所有关联报表（严重数据丢失） | 绝对避免用于此场景 |
| SET_DEFAULT | ⚠️ 仅当有合理默认值（如“通用配件”）时可用 | 默认值需提前定义且语义清晰 |
| DO_NOTHING | ? 危险！可能破坏数据库参照完整性 | SQLite 不校验外键，但 PostgreSQL/MySQL 会报错 |
? 最佳实践建议
- 永远不要物理删除关键业务实体：对库存项启用软删除（如添加 is_active 字段 + 自定义管理器），比硬删更安全；
- 添加归档视图：为管理员提供“已停用库存项”列表，避免误删；
- 定期备份 db.sqlite3：尤其在执行迁移前，防止意外数据损坏。
通过合理配置 on_delete 并辅以前端容错处理，您既能维护数据库一致性，又能保障历史报表长期可用——这才是企业级 CRM 的稳健设计之道。
