solr中通过fieldtype定义数据解析与索引方式，需指定name和class；常用类型包括textfield（文本分词）、strfield（字符串）、pointfield（数值）、datefield（日期）、boolfield（布尔）；配置时注意docvalues、stored、indexed等属性及分词器集成。
在 Solr 中，schema.xml（或较新版本中的 managed-schema）用于定义字段类型（fieldType）和字段（field）。配置字段类型的核心是 <fieldtype></fieldtype> 标签，它告诉 Solr 如何解析、分词、索引和查询该类型的数据。
⚠️ 注意：Solr 8.0+ 默认使用 managed-schema（由 API 动态管理），不再推荐直接编辑
schema.xml。但如果你用的是旧版（如 Solr 7.x 及之前），或明确启用了 classic schema 模式，仍会用到schema.xml。以下以schema.xml为例说明，逻辑同样适用于managed-schema的 XML 结构。
定义基础字段类型（fieldType）
每个 <fieldtype></fieldtype> 必须指定 name 和 class，常用类包括：
-
solr.TextField：支持分词，适合文本搜索（如标题、内容） -
solr.StrField：不分词的字符串，适合 ID、状态码、枚举值等 -
solr.IntPointField/solr.LongPointField/solr.FloatPointField：新一代数值字段（推荐替代老的Trie*Field），支持范围查询、排序、聚合 -
solr.DateField：ISO 8601 格式日期（如2023-05-20T10:30:00Z） -
solr.BoolField：布尔值（接受true/false、t/f、1/0等）
示例：定义一个中文文本字段类型（需配合 IK 或 HanLP 分词器）：
<fieldType name="text_ik" class="solr.TextField">
<analyzer type="index">
<tokenizer class="org.wltea.analyzer.lucene.IKTokenizerFactory" useSmart="false"/>
</analyzer>
<analyzer type="query">
<tokenizer class="org.wltea.analyzer.lucene.IKTokenizerFactory" useSmart="true"/>
</analyzer>
</fieldType>说明：
- `type="index"` 控制索引时如何分词（建议细粒度）
- `type="query"` 控制查询时如何分词（建议智能分词，提升召回）
- 确保对应分词器 JAR 已放入 `solrhome/server/solr-webapp/webapp/WEB-INF/lib/`
常用字段类型配置要点
不同数据类型要注意关键属性和陷阱：
- 字符串 ID 字段：用 `solr.StrField`，并设 `docValues="true"`（方便 facet、排序、脚本）
-
数值字段：优先用 `IntPointField` 而非 `TrieIntField`（后者已弃用），如：
- 多值字段：字段本身设 `multiValued="true"`，字段类型无需特殊配置（如 `text_ik` 本身就支持多值）
- 是否存储（stored）：`stored="true"` 才能在结果中返回该字段值；若只用于检索/排序，可设 `false` 节省空间
- 是否索引（indexed）：`indexed="false"` 则不能被搜索或排序（适合日志原始内容等）
关联字段类型与具体字段（field）
定义好 fieldType 后，在 <fields></fields> 区块中声明实际字段，并引用类型：
<field name="id" type="string" indexed="true" stored="true" required="true" primaryKey="true"/> <field name="title" type="text_ik" indexed="true" stored="true"/> <field name="price" type="p_price" indexed="true" stored="true" docValues="true"/> <field name="tags" type="string" indexed="true" stored="true" multiValued="true"/>
注意：
- `string` 是 Solr 自带的默认 `StrField` 类型（在 schema 开头有定义）
- `primaryKey="true"` 仅语义标识，不影响功能（Solr 无传统主键约束）
- 所有 `field` 的 `type` 值必须已在 `
` 中明确定义过
验证与调试技巧
改完 schema 后必须重启 Solr 或重载 core，否则不生效。
- 访问 http://localhost:8983/solr/#/your-core/schema 查看当前 schema 结构（UI 可视化）
- 用 Schema API 检查字段类型：
GET /solr/your-core/schema/fieldtypes/text_ik - 测试分词效果：
http://localhost:8983/solr/your-core/analysis/field?analysis.fieldvalue=手机壳&analysis.fieldname=title - 字段未返回？检查 `stored="true"`；搜不到？检查 `indexed="true"` 和分词是否合理
基本上就这些。字段类型配置不复杂，但细节决定搜索质量——尤其是分词器选择和 docValues 设置，容易忽略却影响巨大。
