You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

JMeter报错javax.net.ssl.SSLHandshakeException:远程主机终止握手

执行JMeter单线程测试场景时,触发报错:
javax.net.ssl.SSLHandshakeException: Remote host terminated the handshake
报错截图:
JMeter SSL握手异常报错截图

问题产生原因

这个报错本质是JMeter与目标服务端建立HTTPS连接的TLS握手阶段,连接被服务端或中间网络设备主动中断,常见原因有这几类:

  • TLS协议版本不匹配:JMeter配置的TLS版本不在服务端允许的支持范围内,比如旧版JMeter默认仅启用TLSv1.2,而目标服务端已强制要求TLSv1.3,或服务端已禁用低版本TLS协议
  • 加密套件无交集:JMeter支持的TLS加密算法套件和服务端配置的允许套件没有重叠项,加密参数协商失败
  • 证书校验异常:目标服务端使用自签名证书、证书过期、证书绑定域名与实际请求域名不一致,且证书未被JMeter的信任库收录,部分服务端会直接断开连接而非返回明确证书错误
  • SNI字段缺失:目标服务端同IP挂载了多个HTTPS站点,JMeter发起握手时未携带SNI(服务器名称指示)字段,服务端无法匹配对应站点证书,直接终止握手
  • 中间链路拦截:防火墙、WAF、正向代理设备识别到JMeter请求特征,主动拦截断开TLS握手
  • 客户端实现配置错误:HTTP请求选择的客户端实现与目标服务端的SSL逻辑不兼容
排查与解决步骤

按优先级从高到低操作,无需全部尝试:

  1. 开启SSL调试日志定位具体断点
    打开JMeter安装目录bin下的启动脚本(Windows为jmeter.bat,Linux/Mac为jmeter.sh),在JVM启动参数中添加配置:
    -Djavax.net.debug=ssl,handshake
    
    重启JMeter重新运行场景,控制台会打印完整的TLS握手交互日志,可直接定位是版本协商失败、套件不匹配还是证书校验阶段出问题,避免无意义试错。
  2. 对齐TLS协议版本
    打开bin目录下的jmeter.properties配置文件,找到https.protocols配置项,去掉行首的注释符号#,配置为目标服务端支持的TLS版本,例如:
    https.protocols=TLSv1.2,TLSv1.3
    
    若不清楚服务端支持的TLS版本,可在本地执行openssl命令探测:openssl s_client -connect 目标域名:443 -tls1_3,替换tls1_3为tls1_2等版本,返回正常证书信息则说明对应版本被支持。注意:配置完成后必须保存文件、重启JMeter才能生效。
  3. 解决证书信任问题
    • 测试环境可直接跳过证书校验:在HTTP请求默认值或单个HTTP请求的高级设置中,将客户端实现切换为HttpClient4,同时在jmeter.properties中添加配置server.rmi.ssl.disable=true,重启JMeter生效
    • 生产环境建议将服务端的根证书导出,通过keytool命令导入JMeter使用的JRE信任库jre/lib/security/cacerts中,信任库默认密码为changeit
    • 核对请求域名与证书绑定域名完全一致,避免直接用IP发起HTTPS请求触发域名校验失败
  4. 补全SNI配置
    JMeter 5.0及以上版本默认开启SNI支持,若使用旧版本,在对应HTTP请求的高级设置中,找到SNI配置项,填入实际请求的目标域名即可。
  5. 排查中间链路拦截
    先用本地浏览器直接访问目标HTTPS地址,确认服务本身可正常访问;若浏览器访问正常,先关闭本地代理、系统防火墙重试;若仍失败,可将HTTP请求的User-Agent修改为Chrome等浏览器的常规UA,排除WAF/防火墙对JMeter默认UA的拦截。
  6. 切换客户端实现
    在HTTP请求或HTTP请求默认值的配置页,将「客户端实现」选项在Java、HttpClient4两个选项间切换重试,不同实现的SSL握手逻辑存在差异,部分场景下可解决兼容问题。

内容的提问来源于stack exchange,提问作者Everest

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 03:51:23