如何用django-elasticsearch-dsl索引django-modeltranslation生成的字段至Elasticsearch？

问题根源 #

django-modeltranslation是通过动态添加字段实现多语言支持的——比如name_ru、content_ru这类字段不会显式写在Model代码里，但在数据库和Model实例上是真实存在的。而django-elasticsearch-dsl默认只会扫描Model类中显式定义的字段，所以会抛出ModelFieldNotMappedError，这就是你遇到问题的核心原因。

优雅解决方案：手动映射翻译字段到Elasticsearch #

你完全不需要折腾禁用app、修改Model的临时方案，只需要在documents.py中正确配置翻译字段的映射，就能让django-elasticsearch-dsl识别这些动态生成的字段。下面提供两种方案，按需选择：

方案1：手动添加翻译字段（适合语言数量少的场景） #

直接在SymbolDocument中为每个翻译字段定义对应的Elasticsearch字段类型，和原字段类型保持一致即可：

from django_elasticsearch_dsl import Document, fields
from django_elasticsearch_dsl.registries import registry
from symbol.models import Symbol

@registry.register_document
class SymbolDocument(Document):
    # 手动定义翻译字段，类型匹配原字段
    name_ru = fields.TextField()
    name_en = fields.TextField()
    tag_ru = fields.TextField()
    tag_en = fields.TextField()
    content_ru = fields.TextField()
    content_en = fields.TextField()
    meaning_ru = fields.TextField()
    meaning_en = fields.TextField()

    class Index:
        name = 'symbols'
        settings = {'number_of_shards': 1, 'number_of_replicas': 0}

    class Django:
        model = Symbol
        fields = [
            'symbol',
            'name',  # 保留原字段，对应默认语言
            'tag',
            'content',
            'meaning',
            'shortcode',
            'codepoint',
            'slug',
            'id',
        ]
        # 注意：翻译字段不用加到fields列表里，我们已经在上方显式定义了

方案2：自动获取所有翻译字段（适合多语言场景） #

如果你的项目支持多种语言，手动写每个字段太麻烦，可以利用modeltranslation的translatorAPI自动获取所有已注册的翻译字段，动态添加到Document中：

from django_elasticsearch_dsl import Document, fields
from django_elasticsearch_dsl.registries import registry
from modeltranslation.translator import translator
from symbol.models import Symbol

@registry.register_document
class SymbolDocument(Document):
    class Index:
        name = 'symbols'
        settings = {'number_of_shards': 1, 'number_of_replicas': 0}

    class Django:
        model = Symbol
        fields = [
            'symbol',
            'name',
            'tag',
            'content',
            'meaning',
            'shortcode',
            'codepoint',
            'slug',
            'id',
        ]

# 动态添加所有翻译字段
translation_options = translator.get_options_for_model(Symbol)
for field_name in translation_options.fields:
    for lang in translation_options.target_languages:
        # 构造翻译字段名，比如name_ru
        translated_field = f"{field_name}_{lang}"
        # 根据原字段类型匹配Elasticsearch字段，这里统一用TextField支持分词
        setattr(SymbolDocument, translated_field, fields.TextField())

验证步骤 #

1. 保存修改后的documents.py
2. 执行索引重建命令：

   python3 manage.py search_index --rebuild
   

   这时候应该不会再出现ModelFieldNotMappedError了，因为我们已经明确告诉django-elasticsearch-dsl这些翻译字段的存在。

额外提示 #

• 确保settings.py中已正确配置目标语言：

  MODELTRANSLATION_LANGUAGES = ('en', 'ru')
  MODELTRANSLATION_DEFAULT_LANGUAGE = 'en'
  

• 如果需要对特定语言的字段设置专属分词器（比如俄语），可以在定义字段时指定：

  name_ru = fields.TextField(analyzer='russian')
  

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