1. 介紹

Retrofit

Retrofit 是 Square 公司開發的一個類型安全的 HTTP 客戶端庫，主要用于 Android 和 Java 應用。它將 HTTP API 轉換為 Java 接口，通過注解來描述 HTTP 請求。

主要特點:

• 基于注解的 API 定義
• 支持同步和異步調用
• 支持多種數據格式轉換 (JSON, XML 等)
• 可與 RxJava、Coroutines 等集成
• 主要用于移動端開發

Feign

Feign 是 Netflix 開發的一個聲明式 Web Service 客戶端，后被納入 Spring Cloud 生態。它使得編寫 Web Service 客戶端變得更簡單。

主要特點:

• 聲明式的 REST 客戶端
• 與 Spring Cloud 深度集成
• 支持負載均衡 (與 Ribbon 集成)
• 支持服務發現 (與 Eureka 集成)
• 主要用于微服務間的調用

2. 對比

特性	Retrofit	Feign
開發公司	Square	Netflix (現屬于 Spring Cloud)
主要使用場景	Android/Java 客戶端應用	微服務間調用
注解支持	是	是
同步/異步	都支持	主要同步，可通過其他方式實現異步
集成能力	OkHttp, RxJava, Coroutines	Ribbon, Hystrix, Eureka
配置復雜度	相對簡單	與 Spring Cloud 集成時較復雜
負載均衡	不支持	支持 (通過 Ribbon)
服務發現	不支持	支持 (通過 Eureka)
社區支持	主要面向移動端	主要面向微服務

3. 示例代碼

Retrofit 示例

// 1. 定義接口
public interface GitHubService {@GET("users/{user}/repos")Call<List<Repo>> listRepos(@Path("user") String user);@GET("users/{user}/repos")Observable<List<Repo>> listReposRx(@Path("user") String user);
}// 2. 創建 Retrofit 實例
Retrofit retrofit = new Retrofit.Builder().baseUrl("https://api.github.com/").addConverterFactory(GsonConverterFactory.create()).addCallAdapterFactory(RxJava2CallAdapterFactory.create()).build();// 3. 創建服務實例
GitHubService service = retrofit.create(GitHubService.class);// 4. 同步調用
Call<List<Repo>> call = service.listRepos("octocat");
Response<List<Repo>> response = call.execute();// 5. 異步調用
call.enqueue(new Callback<List<Repo>>() {@Overridepublic void onResponse(Call<List<Repo>> call, Response<List<Repo>> response) {// 處理響應}@Overridepublic void onFailure(Call<List<Repo>> call, Throwable t) {// 處理錯誤}
});// 6. RxJava 方式調用
service.listReposRx("octocat").subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(repos -> {// 處理結果}, throwable -> {// 處理錯誤});

Feign 示例

// 1. 添加依賴 (Spring Cloud OpenFeign)
// 在Spring Boot應用中// 2. 啟用Feign客戶端
@SpringBootApplication
@EnableFeignClients
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}
}// 3. 定義Feign客戶端接口
@FeignClient(name = "github-client", url = "https://api.github.com")
public interface GitHubClient {@GetMapping("/users/{user}/repos")List<Repo> listRepos(@PathVariable("user") String user);// 帶負載均衡的示例 (需要服務注冊中心)@FeignClient(name = "user-service") // 從注冊中心獲取服務實例@GetMapping("/api/users/{id}")User getUserById(@PathVariable("id") Long id);
}// 4. 在Controller或Service中使用
@RestController
public class MyController {private final GitHubClient gitHubClient;public MyController(GitHubClient gitHubClient) {this.gitHubClient = gitHubClient;}@GetMapping("/repos/{user}")public List<Repo> getRepos(@PathVariable String user) {return gitHubClient.listRepos(user);}
}// 5. 配置示例 (application.yml)
feign:client:config:default:connectTimeout: 5000readTimeout: 5000loggerLevel: basichystrix:enabled: true # 啟用熔斷

4. 如何選擇

• 選擇 Retrofit 當:

  • 開發 Android 應用
  • 需要與 RxJava 或 Coroutines 集成
  • 調用第三方 API 而非自己的微服務
  • 需要更輕量級的解決方案

• 選擇 Feign 當:

  • 開發 Spring Cloud 微服務
  • 需要服務發現和負載均衡
  • 需要與 Hystrix 熔斷器集成
  • 在服務間進行 REST 調用

兩者都是優秀的 HTTP 客戶端庫，選擇取決于具體的使用場景和技術棧。

如果需要更復雜的微服務功能（如負載均衡、服務發現），Feign 仍是更好的選擇，但 Retrofit 在客戶端場景下的簡潔性和性能表現更勝一籌。