django 4.0 原生尚不支持复合外键（composite foreign key），但可通过 `foreignobject` 手动模拟其行为，结合数据库约束与应用层校验，安全、兼容地实现跨双字段的关联逻辑。
在 Django 中，标准的 ForeignKey 仅支持单字段引用，而业务中常需基于多个字段（如 order_id + department_id）建立强关联关系。虽然 Django 官方已在 PR #18056 中推进 CompositePrimaryKey 和增强型 ForeignObject 支持，但该功能尚未合并入正式版（截至 Django 4.2/5.0），因此生产环境推荐采用稳定、无第三方依赖的原生方案：ForeignObject + 数据库级唯一约束 + 模型层校验。
以下是以您提供的 Orders 与 OrderItems 模型为例的完整实现：
# models.py
from django.db import models
class Order(models.Model):
id = models.AutoField(primary_key=True)
order_id = models.CharField(max_length=255, db_index=True)
department_id = models.CharField(max_length=255, db_index=True)
# 确保 (order_id, department_id) 组合全局唯一，为外键模拟提供基础
class Meta:
constraints = [
models.UniqueConstraint(
fields=['order_id', 'department_id'],
name='unique_order_department'
)
]
def __str__(self):
return f"{self.order_id}-{self.department_id}"
class OrderItem(models.Model):
id = models.AutoField(primary_key=True)
order_item_id = models.CharField(max_length=255)
department_id = models.CharField(max_length=255)
# 使用 ForeignObject 模拟复合外键：关联到 Order 的 (order_id, department_id)
order = models.ForeignObject(
Order,
on_delete=models.PROTECT,
from_fields=['order_item_id', 'department_id'], # 当前模型的两个字段
to_fields=['order_id', 'department_id'], # 目标模型的对应字段
related_name='items'
)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
def clean(self):
# 应用层校验：确保关联存在（可选，增强健壮性）
if self.order_item_id and self.department_id:
try:
Order.objects.get(
order_id=self.order_item_id,
department_id=self.department_id
)
except Order.DoesNotExist:
raise ValidationError(
f"No Order found with order_id='{self.order_item_id}' "
f"and department_id='{self.department_id}'"
)
def save(self, *args, **kwargs):
self.full_clean() # 触发 clean() 校验
super().save(*args, **kwargs)✅ 关键说明：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- ForeignObject 是 Django 提供的底层机制，支持多字段 from_fields ↔ to_fields 映射，虽不生成数据库外键约束（即不触发 SQL FOREIGN KEY），但完全兼容 ORM 查询（如 item.order, order.items.all()）。
- 必须配合 UniqueConstraint（或数据库层面的 UNIQUE INDEX）确保被引用字段组合唯一，否则 ForeignObject 关联将失效或产生歧义。
- 若需数据库级强制完整性，可在迁移中手动添加 SQL 外键（需 DB 支持，如 PostgreSQL）：
ALTER TABLE myapp_orderitem ADD CONSTRAINT fk_order_item_order FOREIGN KEY (order_item_id, department_id) REFERENCES myapp_order(order_id, department_id) ON DELETE PROTECT;（注意：Django 迁移不自动生成此语句，需通过 RunSQL 编写自定义迁移）
⚠️ 注意事项：
- ForeignObject 不支持 select_related() 的深度预取（会忽略 to_fields），但 prefetch_related() 和反向关系正常工作；
- admin 中无法直接使用 raw_id_fields 或 autocomplete_fields 关联 ForeignObject 字段，需自定义 formfield_for_foreignkey；
- 避免与 ForeignKey 混用同一字段组，易引发迁移冲突。
综上，ForeignObject 是 Django 4.0+ 下实现复合外键最轻量、可控且无兼容风险的方案。待官方 CompositePrimaryKey 功能落地后，可平滑升级——当前阶段，它已是企业级项目的可靠实践选择。
