需修改各服务实例注册时的元数据配置，如Consul的service.meta、Nacos的instance.metadata、Eureka的metadata-map或HTTP上报JSON中的display_name_verbose字段。

修改 display_name_verbose 需要改哪里？

这个参数不是全局配置项，也不是前端硬编码的字符串，它来自每个服务器实例的元数据定义。你得去每台服务器对应的配置文件或注册代码里改，而不是在列表渲染逻辑里统一替换。

• 如果是用 Consul、Nacos、Eureka 等注册中心，display_name_verbose 通常对应服务实例的 metadata 字段（如 Consul 的 tags 或自定义 meta）
• 如果是自研服务发现 + HTTP 接口上报，那大概率是上报 JSON 里的一个字段，比如：{"id":"srv-a-01","display_name_verbose":"订单服务（上海集群）"}
• 前端读取列表时，只是把后端返回的这个字段原样展示，不会二次加工

不同注册方式下怎么设 display_name_verbose？

写法差异很大，关键看你是怎么把服务注册上去的 —— 同一个字段，在不同协议里位置和命名可能完全不同。

• Consul：注册时在 service.meta 里加键值对，例如 "display_name_verbose": "用户中心（杭州机房）"
• Nacos：用 instance.ephemeral 注册时，把 metadata 对象带上，字段名就是 display_name_verbose
• Spring Cloud Eureka：不原生支持该字段，得靠 instance.metadata-map 配置，例如 eureka.instance.metadata-map.display_name_verbose=支付网关（灰度环境）
• 直连 HTTP 上报：确保 POST 到 /register 的 body 中包含 display_name_verbose 字段，且后端校验逻辑允许它被存入数据库或缓存

为什么改了没生效？常见卡点

改完配置不显示新名字，八成不是前端问题，而是注册信息根本没刷新进来。

• 服务重启后没重新注册：有些 SDK 默认只在启动时注册一次，改了 metadata 不重启就无效
• 注册中心缓存未更新：Consul 的 catalog.services 接口有默认 1 秒 TTL，但前端轮询间隔如果太长，会看到旧数据
• 字段名拼错或大小写不符：比如写了 DisplayNameVerbose 或 displayname_verbose，后端解析时直接忽略
• 前端用了别名字段：检查 JS 里渲染列表时读的是不是 item.display_name_verbose，还是误写成了 item.name 或 item.serviceName

要不要在前端 fallback 处理？

可以，但只建议作为兜底，不能替代后端正确设置。因为友好名称常含业务上下文（如“生产库”“灾备链路”），前端没法凭空生成。

• 如果后端没传 display_name_verbose，可以用 serviceId + "-" + instanceId 拼一个临时名，比如 "order-srv-us-west-02"
• 避免用 hostname 或 IP 直接展示 —— 容器环境下 hostname 是随机字符串，毫无可读性
• 别在前端做映射表（比如 {“srv-a”: “用户服务”}），维护成本高，且多环境容易对不上

改这个参数最麻烦的不是语法，是确认「谁在负责注册」和「当前注册流程是否真的把新字段带过去了」。很多团队卡在以为改了配置就完事，其实服务压根没带着新 metadata 重注册。