django-elasticsearch-dsl NestedField未同步数据库关联数据问题

核心问题是Django外键反向关联名配置与Document引用的关联名不匹配，导致ORM无法从City模型实例拉取关联的Address数据，Nested字段自然同步不到内容。
你在Address模型的city外键上设置的related_name="related_city"配置错误：related_name参数定义的是从City模型反向访问关联Address集合的属性名，当前配置下你只能通过city.related_city.all()拿到关联地址，但你在Document中定义的NestedField名为addresses，get_queryset里预加载的也是addresses，ORM找不到对应属性，自然无法获取关联数据。

1. 修正外键反向关联名 #

修改models.py中Address模型的外键配置，将related_name改为与NestedField同名的addresses，符合语义也和现有Document配置匹配：

class Address(models.Model):
    city = models.ForeignKey(
        City, on_delete=models.CASCADE, related_name="addresses"
    )
    street_name = models.CharField(max_length=300)
    street_no = models.PositiveIntegerField()
    postal_code = models.CharField(max_length=6)

    def __str__(self):
        return f"{self.street_name} {self.street_no} ({self.city.name})"

修改完成后执行迁移命令同步数据库配置：

python manage.py makemigrations
python manage.py migrate

如果你坚持不修改related_name，也可以将Document中NestedField的attr参数设为"related_city"，同时把get_queryset里prefetch_related的参数改为"related_city"，但这种命名语义完全混乱，非常不推荐。

2. （推荐）显式指定NestedField的关联属性 #

给NestedField加上attr参数显式绑定要读取的模型关联属性，避免后续字段改名时出现隐式匹配错误：

@registry.register_document
class CityDocument(Document):
    addresses = fields.NestedField(
        attr="addresses",
        properties={
            "street_name": fields.TextField(),
            "street_no": fields.IntegerField(),
            "postal_code": fields.TextField(),
            "pk": fields.IntegerField(),
        }
    )

    class Index:
        name = "cities"

    class Django:
        model = City
        fields = ["name", "country"]
        related_models = [Address]

    def get_queryset(self):
        return super().get_queryset().prefetch_related("addresses")

    def get_instances_from_related(self, related_instance):
        if isinstance(related_instance, Address):
            return related_instance.city

3. 重建全量索引 #

之前同步到ES的数据中addresses字段为空，配置修正后需要重建索引完成全量同步：

python manage.py search_index --rebuild -f

在Django shell中执行以下代码，确认ORM关联正常：

from your_app.models import City
# 取第一个城市实例
city = City.objects.first()
# 能正常返回关联的Address查询集就说明关联配置正确
print(city.addresses.all())

关联正常的话，查询ES中cities索引的文档，就能看到addresses nested字段下已经正确写入关联的地址数据，后续Address的增删改操作也会正常触发关联City文档的索引更新。

内容的提问来源于stack exchange，提问作者WiktorKS