如何配置微服务以域名方式注册到Netflix Eureka？

核心原因与解决方案 #

1. 修正hostname配置语法 #

你之前的hostname={$HOST}写法错误，Spring Boot中引用环境变量的正确语法是${HOST}，且环境变量传入的必须是纯域名（不带http/https前缀），比如www.google.com，而非完整URL。

配置示例（YAML）：

eureka:
  instance:
    prefer-ip-address: false  # 禁用IP优先，改用hostname
    hostname: ${HOST}  # 从环境变量HOST读取自定义域名

配置示例（Properties）：

eureka.instance.prefer-ip-address=false
eureka.instance.hostname=${HOST}

2. 配置HTTPS访问（如果需要） #

如果你的服务是HTTPS协议，需要额外配置Eureka实例的安全端口和访问URL，确保Eureka注册的地址是HTTPS格式：

YAML配置：

eureka:
  instance:
    non-secure-port-enabled: false  # 禁用HTTP端口
    secure-port-enabled: true       # 启用HTTPS端口
    secure-port: ${server.port:443} # 服务的HTTPS端口
    # 配置各端点的HTTPS地址
    status-page-url: https://${eureka.instance.hostname}/actuator/info
    health-check-url: https://${eureka.instance.hostname}/actuator/health
    home-page-url: https://${eureka.instance.hostname}/

3. 验证环境变量是否正确传入 #

确保PaaS环境已经正确注入HOST环境变量，值为你需要的纯域名。可以通过以下方式验证：

• 在应用启动日志中打印${HOST}的值
• 访问Spring Boot Actuator的/actuator/env端点，查看HOST变量的实际值

4. 自定义EurekaInstanceConfigBean（极端场景） #

如果上述配置仍不生效，可以通过自定义配置类手动设置hostname：

import org.springframework.cloud.netflix.eureka.EurekaInstanceConfigBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;

@Configuration
public class CustomEurekaConfig {

    @Bean
    public EurekaInstanceConfigBean eurekaInstanceConfig(Environment env) {
        EurekaInstanceConfigBean config = new EurekaInstanceConfigBean();
        config.setPreferIpAddress(false);
        // 从环境变量获取自定义域名
        String customDomain = env.getProperty("HOST");
        config.setHostname(customDomain);
        
        // 配置HTTPS相关（按需启用）
        config.setSecurePortEnabled(true);
        config.setNonSecurePortEnabled(false);
        config.setSecurePort(env.getProperty("server.port", Integer.class, 443));
        config.setStatusPageUrl("https://" + customDomain + "/actuator/info");
        config.setHealthCheckUrl("https://" + customDomain + "/actuator/health");
        config.setHomePageUrl("https://" + customDomain + "/");
        
        return config;
    }
}

内容的提问来源于stack exchange，提问作者ECHU