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)✅ 关键说明：
- 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 编写自定义迁移）
外贸中英文双语企业网站管理系统2025.7.21下载外贸中英繁三语企业网站管理系统是一套专为外贸企业建站首选的信息网站管理系统，中英繁三种语言同步更新模板风格宽频页面十分大方。宁志网站管理系统是国内知名建站软件，它由技术人员开发好了的一种现成建站软件，主要为全国各外贸企业，事业单位、企业公司、自助建站提供方便。网站系统无复杂的安装设置要求，适合广大工作人员使用。特点：安全、稳定、美观、实用、易操作...
⚠️ 注意事项：
- ForeignObject 不支持 select_related() 的深度预取（会忽略 to_fields），但 prefetch_related() 和反向关系正常工作；
- admin 中无法直接使用 raw_id_fields 或 autocomplete_fields 关联 ForeignObject 字段，需自定义 formfield_for_foreignkey；
- 避免与 ForeignKey 混用同一字段组，易引发迁移冲突。
综上，ForeignObject 是 Django 4.0+ 下实现复合外键最轻量、可控且无兼容风险的方案。待官方 CompositePrimaryKey 功能落地后，可平滑升级——当前阶段，它已是企业级项目的可靠实践选择。
