CloseableHttpClient未拦截非法URL：如何验证错误格式URL？

核心原因 #

CloseableHttpClient默认的URL解析与自动修复逻辑和浏览器、Postman不同：它会尝试将格式异常的URL（如包含..://、方括号主机名的结构）调整为合法路径发送到服务器，而部分服务器会接收任意路径请求并返回200（比如默认页面、统一错误页），导致你无法通过响应状态码判断URL格式问题。

解决步骤 #

1. 提前做严格的URL格式校验 #

不要依赖HttpClient的自动处理，先用Java原生的URI或URL类做前置校验，它们对URL规范的校验更严格，非法格式会直接抛出异常：

try {
    // 基础格式校验
    URI uri = new URI("http://machineName:port..://");
    
    // 额外校验主机名格式（禁止方括号、非法字符）
    String host = uri.getHost();
    if (host == null || host.matches(".+\\[.*\\]") || !host.matches("[a-zA-Z0-9.-]+")) {
        throw new IllegalArgumentException("主机名格式非法");
    }
    
    // 校验端口合法性
    int port = uri.getPort();
    if (port != -1 && (port < 1 || port > 65535)) {
        throw new IllegalArgumentException("端口号超出合法范围");
    }
} catch (URISyntaxException | IllegalArgumentException e) {
    // 捕获到格式错误，直接处理
    System.err.println("URL格式无效: " + e.getMessage());
}

2. 配置HttpClient禁用自动修复与重定向 #

关闭HttpClient的URL规范化和自动重定向功能，同时添加自定义拦截器，在请求发送前校验原始URL格式：

CloseableHttpClient httpClient = HttpClients.custom()
        // 禁用自动重定向，避免HttpClient跳转修复异常URL
        .disableRedirectHandling()
        // 添加前置拦截器，校验原始请求URL
        .addInterceptorFirst(new HttpRequestInterceptor() {
            @Override
            public void process(HttpRequest request, HttpContext context) throws HttpException, IOException {
                String originalUri = request.getRequestLine().getUri();
                // 自定义规则检测非法格式
                if (originalUri.contains("..://") || originalUri.matches(".+\\[.*\\]/")) {
                    throw new HttpException("检测到无效URL格式");
                }
            }
        })
        .build();

3. 验证实际发送的请求URL #

有时候HttpClient会悄悄修改请求的URI，你可以通过拦截器打印实际发送的地址，确认是否被自动调整：

.addInterceptorFirst(new HttpRequestInterceptor() {
    @Override
    public void process(HttpRequest request, HttpContext context) throws HttpException, IOException {
        System.out.println("原始请求URI: " + request.getRequestLine().getUri());
        if (request instanceof HttpUriRequest) {
            System.out.println("实际发送URI: " + ((HttpUriRequest) request).getURI());
        }
    }
})

4. 结合响应内容判断请求有效性 #

如果服务器对任意路径都返回200，可通过检查响应体内容判断请求是否真的合法：比如对比响应是否为预期的业务内容，或者是否包含服务器内部错误提示。

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