Spring应用ping多URL返回HTTP状态码的最佳实现方式是什么

在Spring生态下开发REST服务做URL连通性检测，不要直接裸用HttpURLConnection手写封装逻辑，首选Spring官方内置的HTTP客户端，不用额外引入第三方依赖，稳定性和易用性对初学者更友好。

客户端选型参考 #

• Spring Boot 3.x / Spring 6及以上版本：选RestClient，同步阻塞模型，写法简单直观，自动管理连接池、连接释放、超时配置，是目前官方首推的同步HTTP客户端。
• 需要并行检测大量URL的场景：选WebClient，基于响应式模型，可以非阻塞并行发起请求，整体检测耗时更短。
• 还在使用Spring Boot 2.x老版本：选RestTemplate，虽然已经进入维护模式，但足够应对简单的检测场景，比自己手写HttpURLConnection靠谱。

不推荐裸用HttpURLConnection的原因：你需要手动处理连接超时、读取超时、连接释放、重定向策略、HTTPS证书校验等一堆细碎逻辑，初学者很容易漏写配置导致连接泄漏、请求挂死。哪怕Spring的SimpleClientHttpRequestFactory底层还是基于HttpURLConnection实现，官方已经把所有常见坑都踩完做了封装，稳定性远高于自己手写的代码。

最简实现示例（基于Spring Boot 3 + RestClient） #

1. 配置带超时的客户端Bean #

检测场景对超时很敏感，一定要手动配置超时时间，不要用默认值：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import org.springframework.web.client.RestClient;

@Configuration
public class PingClientConfig {
    @Bean
    public RestClient pingRestClient() {
        SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
        factory.setConnectTimeout(3000); // 连接超时3秒
        factory.setReadTimeout(5000); // 读取超时5秒，可根据实际需求调整
        return RestClient.builder()
                .requestFactory(factory)
                .build();
    }
}

2. 编写核心检测逻辑 #

优先发HEAD请求，不需要拉取整个响应体，检测速度更快、更省带宽；遇到不支持HEAD请求的站点再降级为GET即可：

import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.web.client.RestClient;
import org.springframework.web.client.RestClientException;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Service
public class UrlPingService {
    private final RestClient pingRestClient;

    // 构造方法注入，Spring会自动装配之前配置的RestClient
    public UrlPingService(RestClient pingRestClient) {
        this.pingRestClient = pingRestClient;
    }

    public Map<String, Object> batchCheckUrlStatus(List<String> targetUrls) {
        Map<String, Object> checkResult = new HashMap<>();
        for (String url : targetUrls) {
            try {
                ResponseEntity<Void> response = pingRestClient.method(HttpMethod.HEAD)
                        .uri(url)
                        .retrieve()
                        .toBodilessEntity();
                // 正常返回就存入HTTP状态码
                checkResult.put(url, response.getStatusCode().value());
            } catch (RestClientException e) {
                // 域名解析失败、连接被拒、超时、SSL错误等统一返回0，也可以自定义错误码区分不同异常
                checkResult.put(url, 0);
            }
        }
        return checkResult;
    }
}

3. 对外提供REST接口 #

Spring会自动把返回的Map序列化为JSON格式，不需要额外做转换：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
import java.util.Map;

@RestController
@RequestMapping("/api/monitor")
public class PingController {
    private final UrlPingService urlPingService;

    public PingController(UrlPingService urlPingService) {
        this.urlPingService = urlPingService;
    }

    @PostMapping("/ping")
    public Map<String, Object> pingBatchUrls(@RequestBody List<String> urls) {
        return urlPingService.batchCheckUrlStatus(urls);
    }
}

初学者避坑提示 #

• 不要上来就发GET请求拉取整个页面内容，会浪费带宽拖慢检测速度，优先用HEAD方法。
• 永远记得配置超时时间，不然遇到网络不通的场景，请求会一直卡住，拖垮整个服务。
• 如果单次要检测的URL超过10个，不要用循环同步请求，可以配线程池或者换WebClient做并行检测，总耗时可以控制在单次请求的超时时间级别。
• 不要把待检测的URL硬编码在代码里，要么通过请求参数传入，要么放到Spring配置文件里，后续调整不需要重新发版。

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