JHipster Registry 7.1.0部署到ECS时Eureka配置不生效报UnknownHostException求助

排查及解决方法 #

1. 修正环境变量名称拼写 #

JHipster Registry 7.x 基于Spring Boot 2.6版本构建，环境变量绑定规则严格，90%以上的默认值不生效问题都是变量名拼写错误导致：

• 正确的Eureka服务地址变量为 EUREKA_CLIENT_SERVICE_URL_DEFAULTZONE，注意 SERVICE 和 URL 之间需要加下划线，拼写错误的SERVICEURL不符合Spring Boot环境变量绑定规则，会被系统忽略，导致加载默认值http://admin:xxx@eureka:8761/eureka/，自然会抛出找不到eureka主机的UnknownHostException异常
• 实例主机名变量 EUREKA_INSTANCE_HOSTNAME 拼写正确，确保填写的值是ECS集群内可正常解析的内网IP或域名即可

2. 补充必要的基础配置变量 #

仅设置Eureka相关变量不足以让配置生效，需要补充以下变量：

• 设置 SPRING_PROFILES_ACTIVE=prod,native：指定启动剖面，未设置的情况下会默认加载dev开发环境配置，直接走内置的默认Eureka地址
• 单节点部署场景下新增两个变量：
  • EUREKA_CLIENT_FETCH_REGISTRY=false
  • EUREKA_CLIENT_REGISTER_WITH_EUREKA=false
    避免Registry尝试向自身或其他Eureka节点注册，引发循环解析问题

3. 调整ECS任务配置 #

• 如果采用awsvpc网络模式，需要检查任务关联的安全组，开放8761端口的入站规则，允许同VPC内的服务访问
• 在容器定义中添加hostname配置项，值和你设置的EUREKA_INSTANCE_HOSTNAME保持一致，避免Spring自动识别容器内部随机主机名导致注册异常

4. 验证配置是否生效 #

容器启动后进入容器内部，访问http://localhost:8761/config端点，查看返回的配置中eureka.client.service-url.defaultZone的值是否符合预期，可快速判断环境变量是否正常加载。

内容的提问来源于stack exchange，提问作者Vanessa S.