Django ORM如何指定外键非id字段为关联条件实现表连接

Django ForeignKey字段默认以关联模型的主键（默认是自增id字段）作为JOIN关联条件，你当前的外键定义未指定关联字段，因此ORM自动生成了关联id的JOIN语句，和预期的关联weapon字段逻辑不符。

按推荐优先级从高到低排列：

方案1：修改外键指定关联字段（ORM原生支持，最推荐） #

Django ForeignKey提供to_field参数，可直接指定关联到目标模型的非主键字段，无需编写额外SQL，完全符合ORM使用规范。
注意：被关联的字段必须添加数据库层面的唯一约束，否则外键无法创建（关系型数据库外键要求关联字段唯一，避免单条记录匹配到多条关联数据的一致性问题）。

1. 修改模型定义：

class weapons(models.Model):
    # 给weapon字段加唯一约束，满足外键关联要求
    weapon = models.CharField(max_length=11, unique=True)
    country = models.IntegerField()
    flags = models.IntegerField(default=0)
    title = models.CharField(max_length=1000)

class compare(models.Model):
    weapon = models.CharField(max_length=11)
    user_id = models.IntegerField()
    flags = models.IntegerField(default=0)
    # to_field指定关联weapons表的weapon字段，db_column复用表现有weapon字段存储外键值，无需额外生成WeaponNode_id列
    WeaponNode = models.ForeignKey(
        weapons,
        on_delete=models.PROTECT,
        to_field='weapon',
        db_column='weapon'
    )

2. 执行数据库迁移：

python manage.py makemigrations
python manage.py migrate

存量数据提示：迁移前请确认compare表的weapon字段值和weapons表的weapon字段值完全匹配，不存在无效值，否则迁移会失败。
修改完成后，你原有查询语句compare.objects.filter(user_id=1).values_list('weapon', 'WeaponNode__title')无需任何改动，ORM将自动生成按weapon字段关联的INNER JOIN语句，返回预期结果，后续所有双下划线跨表查询也会自动遵循这个关联规则。

方案2：不修改表结构，用子查询匹配关联字段 #

如果受存量表限制无法修改外键定义，可使用Subquery按weapon字段匹配关联title，无需改动现有模型结构：

from django.db.models import OuterRef, Subquery

compare.objects.filter(user_id=1).annotate(
    matched_title=Subquery(
        weapons.objects.filter(weapon=OuterRef('weapon')).values('title')[:1]
    )
).values_list('weapon', 'matched_title')

该方案ORM会生成相关子查询匹配weapon字段相等的记录，返回结果和预期JOIN查询一致，性能和JOIN接近。

方案3：直接执行原生SQL #

如果需要严格控制生成的SQL语句格式，可使用Django提供的raw()方法执行原生查询：

results = compare.objects.raw(
    """
    SELECT apps_compare.id, apps_compare.weapon, apps_weapons.title
    FROM apps_compare
    INNER JOIN apps_weapons ON apps_compare.weapon = apps_weapons.weapon
    WHERE apps_compare.user_id = 1
    """
)

注意：raw查询要求SELECT返回的第一个字段必须是compare模型的主键字段（id），否则模型实例化会报错。

内容的提问来源于stack exchange，提问作者Tarık