使用@FeignClient的URL属性调用外部REST API失败问题

问题分析 #

Spring Cloud Feign 2.x版本（对应Spring Boot 2.7.3）中，@FeignClient必须指定name或value属性，哪怕是直接通过url调用未注册到Eureka的外部服务。但如果指定的name不符合合法主机名规则（比如包含下划线、特殊字符），就会触发Service id not legal hostname错误。

解决方案 #

1. 指定合法服务名并关闭服务发现 #

给@FeignClient设置符合主机名规则的name（仅用小写字母、数字、连字符，避免特殊字符），同时通过配置类关闭服务发现，让Feign直接使用指定url发起请求。

步骤1：创建Feign配置类

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignNonDiscoveryConfig {
    @Bean
    public feign.Client client() {
        // 禁用服务发现，使用默认客户端直接请求
        return new feign.Client.Default(null, null);
    }
}

步骤2：修改FeignClient注解

@FeignClient(
    name = "external-sample-api", // 合法服务名，无特殊字符
    url = "${sample.url}",
    configuration = FeignNonDiscoveryConfig.class
)
public interface SampleFeignClient {
    // 定义外部API调用方法
    @GetMapping("/api/sample")
    String getSampleData();
}

2. 简化方案：直接指定合法服务名 #

若无需自定义配置，仅需确保name符合主机名规则，可直接使用以下写法（可选添加decode404处理404场景）：

@FeignClient(
    name = "external-sample-api",
    url = "${sample.url}",
    decode404 = true
)
public interface SampleFeignClient {
    @GetMapping("/api/sample")
    String getSampleData();
}

关键注意点 #

• name是@FeignClient的必填项，用于标识客户端实例，即使不依赖服务发现也不能省略
• 服务名必须符合RFC 1123规范：仅包含小写字母、数字、连字符，且不能以连字符开头或结尾
• 关闭服务发现的配置类可避免Feign去Eureka查找服务，确保直接使用指定url发起请求

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