第 12 章生产实战 —— 动态服务名与动态注册配置模式讲解本章目标讲清楚同一套代码如何通过动态配置变成不同的服务、注册到不同的注册中心。下面用脱敏后的通用配置片段来讲看完你就能读懂企业级微服务的配置套路。示例中的应用名、地址、密钥均为占位示意非真实值。12.1 一句话先理解本章同一个 jar 包 / 同一个镜像靠外部注入的变量决定自己叫什么名字、注册到哪里。代码不变改的只是部署时的环境变量。这就是一次构建到处部署Build once, deploy anywhere。12.2 核心语法${占位符:默认值}Spring 的配置支持这种写法是所有动态配置的基础${APPLICATION_NAME:myapp}含义分两步先找外部有没有APPLICATION_NAME来源环境变量、JVM 参数-D、启动参数等。找到就用外部的值找不到就用冒号后面的默认值myapp。优先级从高到低高的覆盖低的命令行参数 环境变量 配置文件里的默认值关键理解默认值只是兜底生产环境几乎总是被外部变量覆盖。12.3 案例一动态服务名最核心的动态配置看这样一行配置spring:application:name:${APPLICATION_NAME:myapp}--${SERVICE_NAME:integration}-debug拆开看片段外部变量默认值作用${APPLICATION_NAME:myapp}APPLICATION_NAMEmyapp系统名前缀${SERVICE_NAME:integration}SERVICE_NAMEintegration服务名中段-debug无固定用途/环境后缀运行结果取决于注入了什么变量场景注入的变量最终注册名本地啥都不传无myapp--integration-debug生产集成服务APPLICATION_NAMEMYAPPSERVICE_NAMEINTEGRATIONMYAPP--INTEGRATION-debug复用同套代码做另一个服务SERVICE_NAMEREPORTMYAPP--REPORT-debug这正是你问的同一套代码通过不同名称做不同服务只要部署时把SERVICE_NAME换一下同一个 jar 就以另一个身份注册到 Eureka被当成另一个微服务对待。spring.application.name就是这个服务在 Eureka 通讯录里的名字别的服务用这个名字而不是 IP找它。名字变了它在集群里就是另一个人。12.4 案例二动态注册地址 平台鉴权再看注册中心地址这里动态程度更高platform:service:key:${PLATFORM_SERVICE_KEY:xxxxxxxx}token:${PLATFORM_SERVICE_TOKEN:yyyyyyyy}eureka:client:service-url:defaultZone:http://${platform.service.key}:${platform.service.token}${EUREKA_URL:region-eureka.example.com}/eureka这里有三层动态逐层拆解① 占位符还能引用别的配置项${platform.service.key}不是环境变量而是引用上面 yml 里定义的platform.service.key。而platform.service.key自己又是${PLATFORM_SERVICE_KEY:默认值}。所以是变量套变量——最终值仍来自外部注入。②user:passwordhost是 HTTP Basic 认证http:// key : token host /eureka └─用户─┘ └密码┘ └─地址─┘平台侧的 Eureka开了鉴权不是谁都能注册。key当用户名、token当密码带着它们才能连上注册中心。这回答了教程前面没细讲的一点生产 Eureka 通常是要鉴权的不像本地 demo 裸连。③EUREKA_URL可切换多 GEO 关键${EUREKA_URL:region-eureka.example.com}默认连某个区域的 Eureka。部署到另一个区域时注入EUREKA_URLother-region-eureka...即可切换。同一套代码通过变量切到不同 GEO 的注册中心——又一个动态配置的威力。12.5 案例三被调用方的服务名也是配置消费端动态external:basic:MYAPP--BASICsystem:MYAPP--SYSTEMfinance:MYAPP-FINANCE--GATEWAY这些是你要去调用的其他服务的注册名。代码里的 Feign 这样引用FeignClient(name${external.basic})// 从配置读服务名而不是写死publicinterfaceBasicClient{/* ... */}好处换被调服务的名字只改配置、不动代码。这和第 6 章FeignClient(nameuser-service)是同一原理只是把名字抽到了配置里做得更灵活。12.6 案例四配置项之间互相引用spring:log-kafka:log-name:${spring.application.name}-prodlog-name直接复用了上面算好的spring.application.name。如果服务名是MYAPP--INTEGRATION-debug日志名就自动变成MYAPP--INTEGRATION-debug-prod。一处定义处处联动避免手工改多处导致不一致。12.7 这套动态配置解决了什么问题总结能力靠什么实现价值一份产物多处部署${VAR:默认}不为每个环境改代码/重编译同套代码变多个服务SERVICE_NAME动态拼名复用代码降低维护成本多环境隔离名字前后缀 profiledev/uat/prod 互不串多 GEO 切换EUREKA_URL变量一套代码多地域搞定注册中心鉴权key:tokenhost生产安全防乱注册改名不改代码服务名抽成配置 Feign 引用灵活、低耦合12.8 生产最佳实践清单命名统一保持MYAPP--XXX双横线风格环境/用途放后缀且用变量注入别手改。服务名抽成配置被调服务名放external.*Feign 用FeignClient(name${external.xxx})。容器里加 instance-id 防冲突eureka:instance:prefer-ip-address:trueinstance-id:${spring.application.name}:${random.value}优雅下线滚动发布时先摘流量再停避免调到已停实例配合 readiness 探针 / Actuator graceful shutdown。多 GEO 用 profile 变量组合环境用application-{env}.ymlGEO 用EUREKA_URL等变量覆盖环境 × GEO矩阵。12.9 ⚠️ 一个必须重视的安全提醒在很多项目里${VAR:默认值}的默认值直接写了真实密钥例如token:${SERVICE_TOKEN:xxxxxxxx}# JWT/令牌明文password:${DB_PASSWORD:xxxxxxxx}# 数据库明文密码secret-access-key-id:${AWS_SECRET:xxxxxxxx}# 云厂商明文密钥问题默认值里放真密钥 等于没保护。一旦这份文件进了 Git密钥就泄露了。建议改造方向默认值留空或用占位强制从外部注入token:${SERVICE_TOKEN}# 没注入就启动失败逼你走安全通道password:${DB_PASSWORD}真实值放到K8s Secret / Vault / 平台配置中心由平台注入。已经进过仓库的密钥应当轮换改掉而不只是删掉文件。动态配置的终极形态代码里只有占位符真实值全在平台侧开发者看不到也不需要看到。12.10 本章小结动态配置的核心就一个语法${外部变量:默认值}。用它可以实现动态服务名、动态注册地址、动态 GEO、动态被调服务名。服务名 Eureka 里的身份改名字 变成另一个服务。生产 Eureka 通常带鉴权key:tokenhost。最佳实践核心代码不动、只动配置密钥外置、绝不进仓库。
