在 Nacos 服务注册中配置元数据 Metadata 用于路由规则，需要在服务提供端的配置文件中定义 metadata 键值对，并在消费端通过负载均衡策略或 Dubbo 路由规则进行匹配。

快速配置示例

配置文件是元数据录入的主要入口，修改后需重启服务或触发刷新。

spring:
  cloud:
    nacos:
      discovery:
        metadata:
          version: 1.0.0
          region: cn-hangzhou

为什么会这样

元数据是服务实例的附加标签，路由引擎通过匹配标签决定流量走向。

Nacos 客户端在注册心跳时会将 metadata map 发送给服务端，服务端存储在服务实例详情中。消费端拉取服务列表时携带这些元数据，本地负载均衡器或路由规则根据元数据过滤实例。

分步处理

按照配置、注册、规则、验证的顺序执行，确保每一步都有反馈。

1. 在服务提供端配置文件中添加 spring.cloud.nacos.discovery.metadata 配置项。
2. 重启提供端服务，观察启动日志中是否有 Nacos 注册成功的提示。
3. 登录 Nacos 控制台，进入服务列表，点击服务名查看实例详情，确认 metadata 字段已显示。
4. 在消费端配置路由规则，例如使用 Spring Cloud LoadBalancer 的表达式或 Dubbo 的 ConditionRouter。
5. 发起调用请求，观察日志或链路追踪确认流量是否到达指定元数据的实例。

怎么验证是否生效

通过控制台数据一致性检查和实际调用日志确认路由结果。

登录 Nacos 控制台，查看“服务管理 - 服务列表 - 实例列表”，选中实例查看“元数据”列。若控制台显示与配置一致，说明注册成功。在消费端开启调试日志，查看负载均衡选择的实例 IP 和端口，确认是否符合路由规则预期的元数据筛选条件。

常见坑

元数据大小写敏感且部分客户端版本不支持动态刷新。

• Metadata 的 Key 和 Value 均为字符串，区分大小写，路由匹配时需保持一致。
• 部分旧版本 Spring Cloud Alibaba 客户端不支持配置中心动态刷新 metadata，修改后必须重启服务。
• Nacos 控制台展示的元数据可能有延迟，需等待心跳上报周期。

常见问题

修改 Metadata 后需要重启服务吗？

取决于客户端版本，大多数场景需要重启。

早期版本的 Nacos Client 在启动时读取配置，运行中修改配置文件不会自动重新注册元数据。较新版本配合配置中心可能支持刷新，但为了稳妥，生产环境建议重启服务实例。

Nacos 控制台看不到元数据怎么办？

检查客户端版本兼容性及控制台缓存。

确认使用的 Spring Cloud Alibaba 版本与 Nacos Server 版本兼容。尝试刷新浏览器或等待秒级心跳上报。若仍不显示，检查服务端日志是否有解析元数据失败的报错。

参考来源

• Nacos 官方文档 - 使用指南，URL: https://nacos.io/zh-cn/docs/
• Spring Cloud Alibaba 官方文档 - 快速开始，URL: https://sca.aliyun.com/zh-cn/docs/