schema.xml 是 solr 6.x 及之前版本定义索引结构的核心配置文件，声明字段的搜索、分词、存储等行为；7.0+ 虽默认弃用，但存量系统仍广泛依赖，理解它对运维和迁移至关重要。
schema.xml 是 Solr 旧版本（6.x 及之前）中用于定义索引结构的核心配置文件，它声明了哪些字段可被搜索、如何分词、是否存储、是否排序等。Solr 7.0+ 已默认弃用 schema.xml，改用 Schema API 和 _schema 端点动态管理字段，但很多存量系统、教材或 Docker 镜像仍基于它运行——所以理解它仍是实际运维和迁移的刚需。
schema.xml 的核心作用不是“写代码”，而是声明字段行为
它不控制业务逻辑，只告诉 Solr：这个字段叫什么、类型是什么、要不要存原文、能不能当查询条件、要不要参与高亮。所有字段必须属于一个明确的 <fieldtype></fieldtype>，而每个 <fieldtype></fieldtype> 又绑定了具体的 tokenizer 和 filter 链。
-
name属性必须唯一，且不能含空格或特殊字符（如product_name合法，product name不合法） -
type必须是已定义的<fieldtype name="xxx"></fieldtype>中的name值，拼错会导致启动失败 -
indexed="true"才能被搜索；stored="true"才能在结果里返回原始值；两者都为false的字段几乎无意义 -
multiValued="true"表示该字段可存多个值（如标签数组），对应 Java 中的List<string></string>
常见字段定义错误及修复方式
最常踩的坑不是语法写错，而是语义误配：比如把时间戳字段设成 text_general 类型，导致无法范围查询；或把 ID 字段设为 indexed="false"，结果 q=id:123 查不到。
- 需要精确匹配（如 ID、状态码）→ 用
string类型，不要用text_* - 需要全文检索（如商品描述）→ 用
text_general或自定义分词类型，确保indexed="true" - 需要排序/分面（facet）/高亮 → 字段必须
stored="true"，且类型支持（如string支持 facet，text_general默认不支持 facet，需额外加docValues="true"） - 新增字段后 Solr 不生效 → 必须重启 Solr 或重载 core（
curl "http://localhost:8983/solr/mycore/reload"），仅刷新页面无效
一个可用的 product 字段定义示例
以下片段摘自真实 schema.xml，定义了 ID、名称、价格、分类和描述五个字段，覆盖典型搜索场景：
<!-- 唯一标识，精确匹配 + 排序 --> <field name="id" type="string" indexed="true" stored="true" required="true" primaryKey="true"/> <p><!-- 商品名称：支持中文分词、高亮、模糊查询 --> <field name="name" type="text_chinese" indexed="true" stored="true" multiValued="false"/></p><p><!-- 价格：数值范围查询必需，启用 docValues 以支持排序和分面 --> <field name="price" type="pfloat" indexed="true" stored="true" docValues="true"/></p><p><!-- 分类：多值、需分面统计，用 string 类型避免分词 --> <field name="category" type="string" indexed="true" stored="true" multiValued="true" docValues="true"/></p><p><!-- 描述：长文本，仅用于检索，不返回原文（节省存储）--> <field name="description" type="text_chinese" indexed="true" stored="false"/>
注意：text_chinese 并非 Solr 内置类型，需在 <fieldtype></fieldtype> 区块中提前定义（通常基于 SmartCNTokenizerFactory 或 IKAnalyzer）。漏定义该类型会导致 Solr 启动报错：org.apache.solr.common.SolrException: fieldType 'text_chinese' not found。
迁移到 Solr 8+/9+ 时 schema.xml 还要不要碰？
新集群建议完全绕过 schema.xml：用 schema API 动态增删字段（如 POST /solr/mycore/schema/fields），更安全、无需重启。但若你接手的是老系统，别急着重构——先确认当前 Solr 版本：curl http://localhost:8983/solr/version；再检查 solrconfig.xml 中是否启用了 <schemafactory class="ClassicIndexSchemaFactory"></schemafactory>。只要这个配置存在，schema.xml 就仍在生效，擅自删除或改名会导致 core 无法加载。
