Django-haystack+Solr索引异常：字段值为列表而非原始值

我之前在项目里也碰到过一模一样的情况！这其实是Haystack和Solr集成时的典型配置不匹配问题，下面给你一步步排查和解决的方案：

1. 检查SearchIndex中的字段定义 #

Haystack默认会把部分字段处理为多值字段（毕竟Solr原生支持多值存储），但如果你的业务场景里这些字段是单值的，需要显式设置multi_valued=False。

比如你的CategoryIndex可能原来的写法是这样：

from haystack import indexes
from .models import Category

class CategoryIndex(indexes.SearchIndex, indexes.Indexable):
    text = indexes.CharField(document=True, use_template=True)
    name = indexes.CharField(model_attr='name')
    url = indexes.CharField(model_attr='get_absolute_url')

要改成给单值字段加上multi_valued=False参数：

class CategoryIndex(indexes.SearchIndex, indexes.Indexable):
    text = indexes.CharField(document=True, use_template=True)
    # 显式指定为单值字段
    name = indexes.CharField(model_attr='name', multi_valued=False)
    url = indexes.CharField(model_attr='get_absolute_url', multi_valued=False)

注意：text作为文档的主字段，通常会保留多值特性（因为它可能整合了多个字段的内容），所以不用改它。

2. 修正Solr Schema中的字段配置 #

光改Haystack还不够，必须确保Solr的字段定义也是单值的。打开你的Solr Core对应的managed-schema（旧版本是schema.xml），找到相关字段的定义：

原来的多值字段可能是这样：

<field name="name" type="string" indexed="true" stored="true" multiValued="true"/>
<field name="url" type="string" indexed="true" stored="true" multiValued="true"/>
<!-- 包括Haystack自动生成的xxx_str字段 -->
<field name="name_str" type="string" indexed="true" stored="true" multiValued="true"/>

把multiValued="true"改成multiValued="false"：

<field name="name" type="string" indexed="true" stored="true" multiValued="false"/>
<field name="url" type="string" indexed="true" stored="true" multiValued="false"/>
<field name="name_str" type="string" indexed="true" stored="true" multiValued="false"/>

修改完后记得重启Solr服务，让配置生效。

3. 重新构建索引 #

旧的索引数据已经是列表格式了，必须清空后重新生成：

# 清除旧索引（--noinput跳过确认）
python manage.py clear_index --noinput
# 重新构建索引
python manage.py rebuild_index

做完这三步后，再去Solr后台查看索引数据，你会发现那些字段已经是原始值而不是列表了！

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