当前位置:首页 > 技术 > 正文内容

Feign配置HTTPS证书校验忽略的完整方案(保持负载均衡正常)

访客 技术 2026年5月26日 3
  • 同时处理HTTPS的SSL证书校验问题和Feign框架不支持PATCH请求方式的问题

代码 1. 工具类 SslTrustHelper.java

import javax.net.ssl.*;
import java.security.KeyManagementException;
import java.security.NoSuchAlgorithmException;
import java.security.SecureRandom;
import java.security.cert.X509Certificate;

/**
 * SSL证书校验忽略工具类
 */
public class SslTrustHelper {
    
    /**
     * 自定义TrustManager实现,接受任意证书
     */
    public static final X509TrustManager UNSAFE_TRUST_MANAGER = new X509TrustManager() {
        @Override
        public void checkClientTrusted(X509Certificate[] certificates, String authType) {
            // 跳过客户端证书校验
        }

        @Override
        public void checkServerTrusted(X509Certificate[] certificates, String authType) {
            // 跳过服务端证书校验
        }

        @Override
        public X509Certificate[] getAcceptedIssuers() {
            return new X509Certificate[0];
        }
    };

    /**
     * 创建忽略证书校验的SSLContext实例
     *
     * @return 配置完成的SSLContext对象
     * @throws NoSuchAlgorithmException 算法不支持异常
     * @throws KeyManagementException 密钥管理异常
     */
    public static SSLContext createUnsafeSslContext() throws NoSuchAlgorithmException, KeyManagementException {
        SSLContext context = SSLContext.getInstance("TLS");
        context.init(null, new TrustManager[]{UNSAFE_TRUST_MANAGER}, new SecureRandom());
        return context;
    }

    /**
     * 创建忽略主机名验证的HostnameVerifier
     *
     * @return 始终返回true的HostnameVerifier
     */
    public static HostnameVerifier createPermissiveHostnameVerifier() {
        return new HostnameVerifier() {
            @Override
            public boolean verify(String hostname, SSLSession session) {
                return true;
            }
        };
    }
}

代码 2. 配置类 FeignClientConfig.java

import feign.Client;
import feign.okhttp.OkHttpClient;
import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.netflix.ribbon.SpringClientFactory;
import org.springframework.cloud.openfeign.ribbon.CachingSpringLoadBalancerFactory;
import org.springframework.cloud.openfeign.ribbon.LoadBalancerFeignClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.security.KeyManagementException;
import java.security.KeyStoreException;
import java.security.NoSuchAlgorithmException;

@Slf4j
@Configuration
public class FeignClientConfig {

    /**
     * 配置FeignClient以支持HTTPS和PATCH请求
     *
     * @param cachingFactory 负载均衡工厂
     * @param clientFactory 客户端工厂
     * @return 配置完成的Feign Client
     * @throws NoSuchAlgorithmException 算法异常
     * @throws KeyStoreException 密钥库异常
     * @throws KeyManagementException 密钥管理异常
     */
    @Bean
    public Client feignClient(CachingSpringLoadBalancerFactory cachingFactory, 
                              SpringClientFactory clientFactory) 
            throws NoSuchAlgorithmException, KeyStoreException, KeyManagementException {
        
        // 关键:必须使用LoadBalancerFeignClient包装,否则负载均衡将失效
        // 现象:消费者无法从服务注册中心获取服务提供者的IP地址
        
        // 方案一:使用默认Client(仅解决证书验证问题,不支持PATCH)
        // return new LoadBalancerFeignClient(
        //     new Client.Default(sslContext.getSocketFactory(), new NoopHostnameVerifier()),
        //     cachingFactory, clientFactory);
        
        // 方案二:使用OkHttpClient(同时解决证书验证和PATCH方法支持)
        okhttp3.OkHttpClient okHttpClient = new okhttp3.OkHttpClient.Builder()
                .sslSocketFactory(
                    SslTrustHelper.createUnsafeSslContext().getSocketFactory(),
                    SslTrustHelper.UNSAFE_TRUST_MANAGER)
                .hostnameVerifier(SslTrustHelper.createPermissiveHostnameVerifier())
                .build();
        
        return new LoadBalancerFeignClient(
                new OkHttpClient(okHttpClient),
                cachingFactory, 
                clientFactory);
    }
}

核心要点说明

在使用Feign调用HTTPS接口时,主要面临两个挑战:一是SSL证书校验导致的连接失败,二是Feign原生不支持HTTP的PATCH方法。通过上述配置方案,利用OkHttpClient作为底层HTTP客户端,能够完美解决这两个问题。

需要特别注意的是,在配置FeignClient时,必须使用LoadBalancerFeignClient对底层客户端进行包装。如果直接使用普通的Client实例,将导致服务消费者无法从注册中心获取服务提供者的IP地址,负载均衡机制将完全失效。

该方案在Spring Cloud微服务架构中具有广泛的适用性,特别是在开发测试环境需要跳过证书验证的场景下尤为实用。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。