從入門(mén)到實(shí)戰(zhàn)詳解后端實(shí)現(xiàn)接口調(diào)用的完整代碼(Java/Python)
更新時(shí)間：2026年06月10日 08:36:38 作者：程序員Jelena
接口調(diào)用是現(xiàn)代軟件開(kāi)發(fā)中最基礎(chǔ)、最核心的技能之一,本文將從最基礎(chǔ)的?HTTP?請(qǐng)求講起,逐步深入到生產(chǎn)級(jí)的接口調(diào)用方案,涵蓋多種技術(shù)棧和實(shí)際場(chǎng)景,希望對(duì)大家有所幫助
接口調(diào)用是現(xiàn)代軟件開(kāi)發(fā)中最基礎(chǔ)、最核心的技能之一。本文將從最基礎(chǔ)的 HTTP 請(qǐng)求講起，逐步深入到生產(chǎn)級(jí)的接口調(diào)用方案，涵蓋多種技術(shù)棧和實(shí)際場(chǎng)景。
一、基礎(chǔ)篇：HTTP 請(qǐng)求的核心原理
1.1 HTTP 請(qǐng)求的本質(zhì)
一個(gè)完整的 HTTP 請(qǐng)求包含以下要素：
請(qǐng)求行: GET /api/users/1 HTTP/1.1
請(qǐng)求頭:
Host: api.example.com
Content-Type: application/json
Authorization: Bearer xxx
請(qǐng)求體: {"name": "Alice"} (GET請(qǐng)求通常無(wú)請(qǐng)求體)
1.2 最基礎(chǔ)的接口調(diào)用（原生 Java）
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;
public class BasicHttpClient {
public String sendGet(String urlString) throws Exception {
URL url = new URL(urlString);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setConnectTimeout(5000); // 連接超時(shí)
conn.setReadTimeout(5000); // 讀取超時(shí)
int responseCode = conn.getResponseCode();
System.out.println("Response Code: " + responseCode);
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
StringBuilder response = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
return response.toString();
}
public String sendPost(String urlString, String jsonBody) throws Exception {
URL url = new URL(urlString);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true); // 允許寫(xiě)入請(qǐng)求體
// 發(fā)送請(qǐng)求體
try (OutputStream os = conn.getOutputStream()) {
byte[] input = jsonBody.getBytes("utf-8");
os.write(input, 0, input.length);
}
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream(), "utf-8")
);
StringBuilder response = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
response.append(line.trim());
}
return response.toString();
}
}注意：原生 HttpURLConnection 雖然零依賴，但代碼冗長(zhǎng)、功能有限，生產(chǎn)環(huán)境建議使用成熟的 HTTP 客戶端庫(kù)。
二、進(jìn)階篇：使用成熟 HTTP 客戶端
2.1 Apache HttpClient（Java 經(jīng)典方案）
Maven 依賴：
<dependency>
<groupId>org.apache.httpcomponents.client5</groupId>
<artifactId>httpclient5</artifactId>
<version>5.3.1</version>
</dependency>封裝工具類(lèi)：
import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.classic.methods.HttpPost;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.CloseableHttpResponse;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.core5.http.io.entity.EntityUtils;
import org.apache.hc.core5.http.io.entity.StringEntity;
public class ApacheHttpClientUtil {
private static final CloseableHttpClient httpClient = HttpClients.custom()
.setMaxConnTotal(200) // 最大連接數(shù)
.setMaxConnPerRoute(50) // 每個(gè)路由最大連接數(shù)
.build();
/**
* GET 請(qǐng)求
*/
public static String doGet(String url) {
HttpGet httpGet = new HttpGet(url);
httpGet.addHeader("Accept", "application/json");
try (CloseableHttpResponse response = httpClient.execute(httpGet)) {
return EntityUtils.toString(response.getEntity());
} catch (Exception e) {
throw new RuntimeException("GET請(qǐng)求失敗: " + url, e);
}
}
/**
* POST 請(qǐng)求（JSON）
*/
public static String doPost(String url, String jsonBody) {
HttpPost httpPost = new HttpPost(url);
httpPost.addHeader("Content-Type", "application/json");
httpPost.setEntity(new StringEntity(jsonBody));
try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
return EntityUtils.toString(response.getEntity());
} catch (Exception e) {
throw new RuntimeException("POST請(qǐng)求失敗: " + url, e);
}
}
}
2.2 OkHttp（輕量高效，Android 首選）
Maven 依賴：
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>4.12.0</version>
</dependency>同步調(diào)用示例：
import okhttp3.*;
import java.io.IOException;
public class OkHttpDemo {
private static final OkHttpClient client = new OkHttpClient.Builder()
.connectTimeout(10, TimeUnit.SECONDS)
.readTimeout(30, TimeUnit.SECONDS)
.connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES))
.build();
private static final MediaType JSON = MediaType.get("application/json; charset=utf-8");
// GET 請(qǐng)求
public String get(String url) throws IOException {
Request request = new Request.Builder()
.url(url)
.header("User-Agent", "MyApp/1.0")
.build();
try (Response response = client.newCall(request).execute()) {
if (!response.isSuccessful()) {
throw new IOException("Unexpected code: " + response);
}
return response.body().string();
}
}
// POST 請(qǐng)求
public String post(String url, String json) throws IOException {
RequestBody body = RequestBody.create(json, JSON);
Request request = new Request.Builder()
.url(url)
.post(body)
.build();
try (Response response = client.newCall(request).execute()) {
return response.body().string();
}
}
}
異步調(diào)用示例（非阻塞）：
// 異步 GET，不阻塞主線程
client.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
e.printStackTrace();
}
@Override
public void onResponse(Call call, Response response) throws IOException {
try (ResponseBody responseBody = response.body()) {
System.out.println(responseBody.string());
}
}
});
三、實(shí)戰(zhàn)篇：Spring 生態(tài)中的接口調(diào)用
3.1 RestTemplate（Spring 經(jīng)典方案）
import org.springframework.web.client.RestTemplate;
import org.springframework.http.*;
@Configuration
public class RestTemplateConfig {
@Bean
public RestTemplate restTemplate() {
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setConnectTimeout(5000);
factory.setReadTimeout(10000);
return new RestTemplate(factory);
}
}
@Service
public class UserService {
@Autowired
private RestTemplate restTemplate;
public User getUserById(Long id) {
String url = "https://api.example.com/users/{id}";
// 路徑參數(shù) + 返回值自動(dòng)映射
return restTemplate.getForObject(url, User.class, id);
}
public User createUser(User user) {
String url = "https://api.example.com/users";
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
HttpEntity<User> request = new HttpEntity<>(user, headers);
ResponseEntity<User> response = restTemplate.postForEntity(url, request, User.class);
return response.getBody();
}
// 帶請(qǐng)求頭的復(fù)雜調(diào)用
public List<Order> getOrders(String token) {
String url = "https://api.example.com/orders";
HttpHeaders headers = new HttpHeaders();
headers.setBearerAuth(token); // Bearer Token
headers.set("X-Request-Id", UUID.randomUUID().toString());
HttpEntity<String> entity = new HttpEntity<>(headers);
ResponseEntity<Order[]> response = restTemplate.exchange(
url,
HttpMethod.GET,
entity,
Order[].class
);
return Arrays.asList(response.getBody());
}
}
3.2 WebClient（響應(yīng)式，Spring 5+ 推薦）
Maven 依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>基礎(chǔ)使用：
import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;
@Service
public class WebClientService {
private final WebClient webClient;
public WebClientService(WebClient.Builder builder) {
this.webClient = builder
.baseUrl("https://api.example.com")
.defaultHeader("Content-Type", "application/json")
.build();
}
// 同步調(diào)用（阻塞）
public User getUserSync(Long id) {
return webClient.get()
.uri("/users/{id}", id)
.retrieve()
.bodyToMono(User.class)
.block(); // 阻塞等待結(jié)果
}
// 異步調(diào)用（非阻塞，推薦）
public Mono<User> getUserAsync(Long id) {
return webClient.get()
.uri("/users/{id}", id)
.retrieve()
.bodyToMono(User.class);
}
// POST 請(qǐng)求 + 錯(cuò)誤處理
public Mono<Order> createOrder(OrderRequest request) {
return webClient.post()
.uri("/orders")
.bodyValue(request)
.retrieve()
.onStatus(HttpStatusCode::is4xxClientError,
response -> Mono.error(new BusinessException("客戶端錯(cuò)誤")))
.onStatus(HttpStatusCode::is5xxServerError,
response -> Mono.error(new SystemException("服務(wù)端錯(cuò)誤")))
.bodyToMono(Order.class);
}
}
配合 Spring MVC 使用（Controller 層）：
@RestController
public class OrderController {
@Autowired
private WebClientService webClientService;
@GetMapping("/orders/{id}")
public Mono<Order> getOrder(@PathVariable Long id) {
// 全程非阻塞，線程不會(huì)被占用
return webClientService.getOrderAsync(id);
}
}
四、生產(chǎn)級(jí)篇：接口調(diào)用框架封裝
4.1 統(tǒng)一封裝：帶重試、超時(shí)、日志的 HTTP 工具
import lombok.extern.slf4j.Slf4j;
import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;
import org.springframework.stereotype.Component;
import org.springframework.web.client.ResourceAccessException;
@Slf4j
@Component
public class HttpClientWrapper {
@Autowired
private RestTemplate restTemplate;
/**
* 帶重試的 GET 請(qǐng)求
* 遇到 ResourceAccessException（連接超時(shí)、讀取超時(shí)）時(shí)自動(dòng)重試
*/
@Retryable(
retryFor = {ResourceAccessException.class},
maxAttempts = 3,
backoff = @Backoff(delay = 1000, multiplier = 2) // 1s, 2s, 4s
)
public <T> T getWithRetry(String url, Class<T> responseType) {
log.info("發(fā)起請(qǐng)求: {}", url);
long start = System.currentTimeMillis();
try {
T result = restTemplate.getForObject(url, responseType);
log.info("請(qǐng)求成功, 耗時(shí){}ms", System.currentTimeMillis() - start);
return result;
} catch (Exception e) {
log.error("請(qǐng)求失敗: {}, 異常: {}", url, e.getMessage());
throw e;
}
}
}
啟用重試（Spring Boot）：
@EnableRetry
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
4.2 OpenFeign：聲明式 HTTP 客戶端（微服務(wù)首選）
Maven 依賴：
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>定義接口（像調(diào)用本地方法一樣調(diào)用遠(yuǎn)程接口）：
@FeignClient(
name = "user-service",
url = "https://api.example.com",
configuration = FeignConfig.class,
fallbackFactory = UserClientFallbackFactory.class
)
public interface UserClient {
@GetMapping("/users/{id}")
User getUserById(@PathVariable("id") Long id);
@PostMapping("/users")
User createUser(@RequestBody User user);
@GetMapping("/users")
List<User> getUsersByIds(@RequestParam("ids") List<Long> ids);
}
配置類(lèi)：
public class FeignConfig {
@Bean
public Request.Options feignOptions() {
// 連接超時(shí) 5s，讀取超時(shí) 10s
return new Request.Options(5, TimeUnit.SECONDS, 10, TimeUnit.SECONDS, true);
}
@Bean
public Retryer feignRetryer() {
// 初始間隔 100ms，最大間隔 1s，最多重試 3 次（不含首次）
return new Retryer.Default(100, 1000, 3);
}
@Bean
public Logger.Level feignLoggerLevel() {
return Logger.Level.FULL; // 打印完整請(qǐng)求/響應(yīng)
}
}
降級(jí)處理（熔斷時(shí)返回兜底數(shù)據(jù)）：
@Component
@Slf4j
public class UserClientFallbackFactory implements FallbackFactory<UserClient> {
@Override
public UserClient create(Throwable cause) {
log.error("UserClient 調(diào)用失敗: {}", cause.getMessage());
return new UserClient() {
@Override
public User getUserById(Long id) {
// 返回兜底用戶
return User.builder()
.id(id)
.name("未知用戶")
.status("OFFLINE")
.build();
}
@Override
public User createUser(User user) {
throw new BusinessException("用戶服務(wù)暫不可用，請(qǐng)稍后重試");
}
@Override
public List<User> getUsersByIds(List<Long> ids) {
return Collections.emptyList();
}
};
}
}
啟用 Feign：
@EnableFeignClients
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
使用示例：
@Service
public class OrderService {
@Autowired
private UserClient userClient;
public OrderDetail getOrderDetail(Long orderId) {
Order order = orderRepository.findById(orderId);
// 像調(diào)用本地方法一樣調(diào)用遠(yuǎn)程接口
User user = userClient.getUserById(order.getUserId());
return OrderDetail.builder()
.order(order)
.user(user)
.build();
}
}
五、Python 中的接口調(diào)用
5.1 requests 庫(kù)（最常用）
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
# 創(chuàng)建帶重試策略的 Session
session = requests.Session()
# 配置重試：連接錯(cuò)誤重試3次，讀取超時(shí)重試3次，狀態(tài)碼 500/502/503/504 重試3次
retries = Retry(
total=3,
backoff_factor=1, # 間隔 0s, 2s, 4s
status_forcelist=[500, 502, 503, 504],
allowed_methods=["HEAD", "GET", "POST", "PUT", "DELETE"]
)
session.mount('https://', HTTPAdapter(max_retries=retries))
session.mount('http://', HTTPAdapter(max_retries=retries))
# GET 請(qǐng)求
def get_user(user_id: int) -> dict:
url = f"https://api.example.com/users/{user_id}"
response = session.get(url, timeout=(5, 10)) # (連接超時(shí), 讀取超時(shí))
response.raise_for_status() # 狀態(tài)碼 >= 400 時(shí)拋出異常
return response.json()
# POST 請(qǐng)求
def create_user(user_data: dict) -> dict:
url = "https://api.example.com/users"
headers = {"Content-Type": "application/json"}
response = session.post(url, json=user_data, headers=headers, timeout=10)
return response.json()
# 文件上傳
def upload_file(file_path: str) -> dict:
url = "https://api.example.com/upload"
with open(file_path, 'rb') as f:
files = {'file': ('report.pdf', f, 'application/pdf')}
response = session.post(url, files=files)
return response.json()5.2 aiohttp（異步高性能）
import aiohttp
import asyncio
async def fetch_user(session: aiohttp.ClientSession, user_id: int) -> dict:
url = f"https://api.example.com/users/{user_id}"
async with session.get(url) as response:
response.raise_for_status()
return await response.json()
async def main():
# 創(chuàng)建連接池，限制并發(fā)數(shù)
connector = aiohttp.TCPConnector(limit=100, limit_per_host=30)
async with aiohttp.ClientSession(
connector=connector,
timeout=aiohttp.ClientTimeout(total=30)
) as session:
# 并發(fā)請(qǐng)求 10 個(gè)用戶
tasks = [fetch_user(session, i) for i in range(1, 11)]
results = await asyncio.gather(*tasks, return_exceptions=True)
for result in results:
if isinstance(result, Exception):
print(f"請(qǐng)求失敗: {result}")
else:
print(f"用戶: {result}")
asyncio.run(main())六、核心要點(diǎn)總結(jié)
| 維度 | 建議 |
|---|---|
| 超時(shí)設(shè)置 | 必須設(shè)置連接超時(shí)和讀取超時(shí)，避免無(wú)限等待 |
| 連接池 | 復(fù)用連接，減少 TCP 握手開(kāi)銷(xiāo) |
| 重試策略 | 僅對(duì)冪等操作（GET、PUT）重試，POST 需謹(jǐn)慎 |
| 異常處理 | 區(qū)分網(wǎng)絡(luò)異常、超時(shí)異常、業(yè)務(wù)異常 |
| 日志記錄 | 記錄請(qǐng)求 URL、耗時(shí)、狀態(tài)碼，便于排查問(wèn)題 |
| 序列化 | 使用 Jackson/Gson 自動(dòng)處理 JSON 與對(duì)象的映射 |
| 安全 | HTTPS 必用，敏感信息放 Header 而非 URL |
七、選型建議
| 場(chǎng)景 | 推薦方案 |
|---|---|
| 簡(jiǎn)單腳本/爬蟲(chóng) | Python requests |
| Android 開(kāi)發(fā) | OkHttp |
| Spring Boot 單體應(yīng)用 | RestTemplate / WebClient |
| Spring Cloud 微服務(wù) | OpenFeign + Ribbon |
| 高并發(fā)異步場(chǎng)景 | WebClient / aiohttp |
| 需要精細(xì)控制 | Apache HttpClient / OkHttp |
接口調(diào)用的代碼實(shí)現(xiàn)看似簡(jiǎn)單，但要做到穩(wěn)定、高效、可維護(hù)，需要在超時(shí)控制、重試策略、連接管理、異常處理等方面下足功夫。希望本文能為你的接口調(diào)用實(shí)踐提供有價(jià)值的參考。
以上就是從入門(mén)到實(shí)戰(zhàn)詳解后端實(shí)現(xiàn)接口調(diào)用的完整代碼(Java/Python)的詳細(xì)內(nèi)容，更多關(guān)于后端接口調(diào)用方案的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
您可能感興趣的文章:
- python調(diào)用dubbo接口的實(shí)現(xiàn)步驟
- Python調(diào)用Java接口失敗(Java日志打印警告：JSON parse error：xxxx)的解決方案
- Python調(diào)用API接口實(shí)現(xiàn)規(guī)范獲取官方數(shù)據(jù)
- Python調(diào)用Java接口實(shí)現(xiàn)互相SM2加簽驗(yàn)簽
- java調(diào)用第三方接口實(shí)現(xiàn)流式輸出的示例代碼
- Java統(tǒng)計(jì)接口調(diào)用頻率的五種方案及對(duì)比詳解
- Java調(diào)用UniHttp接口請(qǐng)求失敗的三種解決策略
相關(guān)文章
MobaXterm遠(yuǎn)程連接Linux服務(wù)器(Ubuntu)圖文教程
這篇文章主要為大家介紹了MobaXterm遠(yuǎn)程連接Linux服務(wù)器(Ubuntu)的相關(guān)教程，文中通過(guò)圖文進(jìn)行了詳細(xì)的總結(jié)，需要的小伙伴可以收藏下2023-08-08
利用ChatGPT與MindShow制作一個(gè)PPT的方法詳解
PPT制作是商務(wù)、教育和各種場(chǎng)合演講的重要組成部分，然而，很多人會(huì)花費(fèi)大量時(shí)間和精力在內(nèi)容生成和視覺(jué)設(shè)計(jì)方面，為了解決這個(gè)問(wèn)題，我們可以利用兩個(gè)強(qiáng)大的工具——ChatGPT和MindShow，來(lái)提高制作PPT的效率，感興趣的同學(xué)可以參考閱讀2023-06-06
gradle+shell實(shí)現(xiàn)自動(dòng)系統(tǒng)簽名
這篇文章主要介紹了gradle+shell實(shí)現(xiàn)自動(dòng)系統(tǒng)簽名的相關(guān)資料,需要的朋友可以參考下2019-08-08
為什么框架發(fā)展得越來(lái)越好，因?yàn)樵絹?lái)越多的程序員選擇使用框架。當(dāng)處于實(shí)際的項(xiàng)目開(kāi)發(fā)中，程序員就會(huì)發(fā)現(xiàn)項(xiàng)目周期短，使用框架可以最有效地節(jié)約時(shí)間。如果完全從頭開(kāi)始編程，使用時(shí)間太多不說(shuō)，對(duì)程序員的個(gè)人編碼水平也提出了很高的要求2017-08-08
5分鐘獲取deepseek api并搭建簡(jiǎn)易問(wèn)答應(yīng)用
本文主要介紹了5分鐘獲取deepseek api并搭建簡(jiǎn)易問(wèn)答應(yīng)用,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2025-01-01
這篇文章主要為大家詳細(xì)介紹了WebStorm 2019.2安裝配置方法圖文教程，文中安裝步驟介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2020-09-09
matlab讀取串口數(shù)據(jù)并顯示曲線的實(shí)現(xiàn)示例
這篇文章主要介紹了matlab讀取串口數(shù)據(jù)并顯示曲線的實(shí)現(xiàn)示例，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08
PHP和Java的主要區(qū)別有哪些？哪個(gè)最適合Web開(kāi)發(fā)語(yǔ)言？
Java和PHP都是編程語(yǔ)言，大家知道它們最大的區(qū)別就是一個(gè)是靜態(tài)語(yǔ)言一個(gè)是動(dòng)態(tài)語(yǔ)言吧。沒(méi)錯(cuò)，Java是一種靜態(tài)語(yǔ)言，PHP是一種動(dòng)態(tài)語(yǔ)言。那它們還有哪些區(qū)別? 哪個(gè)最適合Web開(kāi)發(fā)語(yǔ)言？下面，小編再給大家詳細(xì)介紹下。2016-08-08
關(guān)于程序員生活的一份調(diào)查，看看你屬于哪一個(gè)群體吧
這篇文章主要介紹了關(guān)于程序員生活的一份調(diào)查，看看你屬于哪一個(gè)群體吧,需要的朋友可以參考下2014-09-09
計(jì)算機(jī)程序設(shè)計(jì)并行計(jì)算概念及定義全面詳解
最近項(xiàng)目需要實(shí)現(xiàn)程序的并行化，剛好借著翻譯這篇帖子的機(jī)會(huì)，了解和熟悉并行計(jì)算的基本概念和程序設(shè)計(jì)，有需要的朋友可以借鑒參考下2021-11-11