需修改各服务实例注册时的元数据配置，如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”: “用户服务”}），维护成本高，且多环境容易对不上
