ES 7.0+ 不支持修改已有字段类型或 analyzer，唯一安全方案是 reindex + alias 切换：新建索引、迁移数据、原子切换 alias 并显式设置 is_write_index。
ES 7.0+ 不支持直接修改已有字段的类型或 analyzer
你没法给一个已经存在的 text 字段临时改成 keyword，也不能把 date 改成 long——elasticsearch 会直接报错 illegal_argument_exception，提示 “mapper [xxx] cannot be changed from type [yyy] to [zzz]”。这不是权限或配置问题，是底层 lucene 的限制：字段映射一旦写入，结构就冻结了。
常见错误现象：MapperParsingException、invalid_type_name_exception 或更新 mapping 时返回 400；你以为只是改个参数，其实 ES 拒绝任何破坏已有数据结构的操作。
- 唯一能安全改的只有少数几项：
ignore_malformed、coerce、copy_to、dynamic（部分场景） -
analyzer可以改，但只对新写入文档生效；老文档的倒排索引不会重建，搜索结果可能不一致 - 如果字段还没写入任何数据（即 index 是空的），可以删掉再建，但生产环境几乎不适用
用 reindex + alias 切换实现“无感”字段变更
真正可行的做法是建个新索引，用新 mapping，再把旧数据搬过去，最后用 alias 原子切换读写目标。整个过程不中断服务，客户端无感知——前提是你的应用通过 alias 访问索引，而不是硬编码索引名。
使用场景：要加字段、改字段类型、调整 analyzer、启用 fielddata、或者从 text 新增 keyword 子字段。
- 先创建新索引，比如
my-index-v2，定义好你要的字段结构 - 用
_reindexAPI 搬数据：POST _reindex { "source": {"index": "my-index"}, "dest": {"index": "my-index-v2"} } - 确认数据一致后，用
POST /_aliases把 alias 从旧索引切到新索引，注意要同时移除旧绑定、添加新绑定 - 旧索引可保留一段时间用于回滚，确认无误后再手动删除
alias 切换时容易漏掉写入路由或别名冲突
alias 不是简单重命名，它本身有读写语义。如果你只改了读 alias，但没设置 "is_write_index": true，新写入还会打到旧索引上，导致数据分裂。
常见错误现象：切换后搜得到旧数据，但新写入查不到；或者 Kibana 显示数据量没涨，但日志里持续有写入成功日志。
- 必须显式指定哪个索引是 write index：
POST /_aliases { "actions": [ {"remove": {"index": "my-index", "alias": "my-alias"}}, {"add": {"index": "my-index-v2", "alias": "my-alias", "is_write_index": true}} ] } - 检查 alias 状态：
GET /my-alias/_alias，确认返回中"is_write_index": true出现在新索引那一行 - 如果旧索引还挂着别的 alias，或被 ILM 策略管理，切换前得先解绑，否则 ILM 可能自动删掉新索引
reindex 性能与数据一致性要点
reindex 不是瞬间完成的，尤其当源索引大、字段多、有 script 转换时，容易超时或 OOM。更重要的是：它不保证实时一致性——源索引在 reindex 过程中仍有写入，这部分增量不会自动同步。
性能影响：默认 scroll 批大小是 1000，网络和磁盘压力小但耗时长；调太高可能触发 circuit breaker；并发数设为 2–4 通常较稳。
- 加
"conflicts": "proceed"避免 version conflict 中断（适合只读迁移） - 用
"script"在搬运时做字段清洗或格式转换，比如把old_field拆成new_field.keyword - 如果业务允许短暂停写，建议先禁用写入（比如切流量、关定时任务），等 reindex 完再开；否则得自己补 delta（例如用 _changes API 或 binlog 同步）
- 大索引务必在低峰期操作，并监控
thread_pool.bulk.queue_size和indices.recovery.max_bytes_per_sec
