Spring Boot调用API的正确方式是什么？使用HttpURLConnection是否合理？

当前实现的合理性分析 #

你当前用HttpURLConnection的写法可以正常运行，但在Spring Boot项目里不属于最佳实践，存在以下明显问题：

• 硬编码所有请求参数、逻辑直接写在启动类main方法中，代码复用性、可维护性极低，后续需要调整请求逻辑、复用API调用能力时无法扩展
• 手动处理URL拼接、编码、流读写、连接关闭，极易出现资源泄漏、编码错误等问题，且没有连接池复用能力，高并发场景下性能表现差
• 同步阻塞的调用逻辑无法和Spring生态的能力（如异常统一处理、参数校验、序列化反序列化自动适配）结合

关于WebClient的说法正误 #

“Spring Boot调用API必须用WebClient”的说法不准确，Spring生态提供了多套HTTP客户端方案，适配不同的技术栈场景：

• 如果你用的是传统Servlet栈（Spring Web）的同步开发场景：优先选RestTemplate（稳定成熟）或者Spring 6+推出的RestClient（API更流畅易用，官方目前推荐的同步方案），不用强行适配响应式逻辑
• 如果你用的是响应式技术栈（Spring WebFlux）：WebClient是官方唯一推荐的HTTP客户端，原生支持非阻塞调用、响应式流背压、函数式编程，性能优势明显

优化参考（以RestTemplate为例，适配大多数常规场景） #

你可以把API调用逻辑抽成独立的Bean，方便后续复用，示例代码如下：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;

@Configuration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.util.UriComponentsBuilder;

@Component
public class WeatherApiClient {
    private static final String BASE_URL = "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst";
    private static final String SERVICE_KEY = "0gr5uJKYx6b%2BlhmOt%2BDm%2BfbcxVdiG7U407njrJ3YSFLlrckPeysX5FZ3qoVA%3D%3D";

    @Autowired
    private RestTemplate restTemplate;

    public String getVilageFcst(String pageNo, String numOfRows, String dataType, String baseDate, String baseTime, String nx, String ny) {
        // 自动处理URL编码、参数拼接
        String url = UriComponentsBuilder.fromHttpUrl(BASE_URL)
                .queryParam("serviceKey", SERVICE_KEY)
                .queryParam("pageNo", pageNo)
                .queryParam("numOfRows", numOfRows)
                .queryParam("dataType", dataType)
                .queryParam("base_date", baseDate)
                .queryParam("base_time", baseTime)
                .queryParam("nx", nx)
                .queryParam("ny", ny)
                .toUriString();
        // 自动处理请求、响应序列化，无需手动操作流
        return restTemplate.getForObject(url, String.class);
    }
}

需要调用的时候直接注入WeatherApiClient调用对应方法即可，不用重复编写连接、编解码逻辑。

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