Elasticsearch 7.10.2映射问题：Kibana可视化仅显示部分Terms字段

我使用Elasticsearch v7.10.2搭配Kibana，创建了ApkHistory索引，映射配置如下：

{
  "apkhistory" : {
    "mappings" : {
      "properties" : {
        "apkId" : {
          "type" : "long"
        },
        "appUserCountry" : {
          "type" : "nested",
          "include_in_parent" : true,
          "properties" : {
            "countryCode" : {
              "type" : "text",
              "fields" : {
                "keyword" : {
                  "type" : "keyword",
                  "ignore_above" : 256
                }
              }
            },
            "currency" : {
              "properties" : {
                "code" : {
                  "type" : "text",
                  "fields" : {
                    "keyword" : {
                      "type" : "keyword",
                      "ignore_above" : 256
                    }
                  }
                },
                "name" : {
                  "type" : "text",
                  "fields" : {
                    "keyword" : {
                      "type" : "keyword",
                      "ignore_above" : 256
                    }
                  }
                },
                "symbole" : {
                  "type" : "text",
                  "fields" : {
                    "keyword" : {
                      "type" : "keyword",
                      "ignore_above" : 256
                    }
                  }
                },
                "usdunit" : {
                  "type" : "float"
                }
              }
            },
            "indicatif" : {
              "type" : "text",
              "fields" : {
                "keyword" : {
                  "type" : "keyword",
                  "ignore_above" : 256
                }
              }
            },
            "name" : {
              "type" : "text",
              "fields" : {
                "keyword" : {
                  "type" : "keyword",
                  "ignore_above" : 256
                }
              }
            }
          }
        },
        "appUserId" : {
          "type" : "text",
          "fields" : {
            "keyword" : {
              "type" : "keyword",
              "ignore_above" : 256
            }
          }
        },
        "date" : {
          "type" : "date"
        },
        "event" : {
          "type" : "text",
          "fields" : {
            "keyword" : {
              "type" : "keyword",
              "ignore_above" : 256
            }
          }
        },
        "isFree" : {
          "type" : "boolean"
        },
        "name" : {
          "type" : "text",
          "fields" : {
            "keyword" : {
              "type" : "keyword",
              "ignore_above" : 256
            }
          }
        }
      }
    }
  }
}

数据已正确保存，但创建可视化时，Terms或Significant Terms中仅显示appUserId.keyword和event.keyword，其余keyword字段未显示，请问我的映射存在什么问题？

问题原因 #

核心问题出在嵌套字段（nested）的子字段识别逻辑：

• Kibana的可视化组件默认不会自动识别嵌套结构下的keyword字段为可聚合字段，即便你设置了include_in_parent: true，Kibana在自动检测字段时仍会将嵌套子字段标记为非聚合可用。
• 顶层的appUserId、event是普通text类型字段，它们的keyword子字段能被正常识别；而appUserCountry下的所有子字段（如countryCode.keyword）、甚至顶层的name.keyword如果未显示，大概率是Kibana字段索引模式未同步或嵌套结构的限制导致。

解决方法 #

1. 手动指定嵌套字段路径
   在Kibana可视化的Terms/Significant Terms面板中，直接手动输入嵌套字段的完整路径，比如appUserCountry.countryCode.keyword、appUserCountry.currency.code.keyword，Kibana会识别这些字段并允许聚合。

2. 将嵌套字段改为普通对象类型（业务允许的情况下）
   若不需要利用嵌套字段的独立查询特性，可以把appUserCountry的类型从nested改为object，这样它的子字段会被当作普通对象字段，Kibana就能自动识别所有keyword子字段。修改后的映射片段如下：

   "appUserCountry" : {
     "type" : "object",
     "properties" : {
       // 原有的子字段配置保持不变
     }
   }
   

   注意：修改映射后需要重新索引数据，因为嵌套字段和普通对象字段的存储结构不同。

3. 刷新Kibana字段索引模式
   进入Kibana的「Stack Management」→「Index Patterns」，找到ApkHistory对应的索引模式，点击「Refresh field list」，确保Kibana加载了最新的字段信息。

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