TLS握手时证书链未传输至服务器问题排查求助

从你贴的代码和SSL调试日志来看，核心问题很明确：客户端在TLS握手阶段没有向服务器发送完整的证书链，导致服务器抛出null cert chain的致命错误。咱们一步步来拆解原因，找到修复方案：

一、先看你的linkToServerCertificate方法里的坑 #

这段代码有两个关键问题，直接导致了证书链无法正常传输：

public boolean linkToServerCertificate(Party server) throws KeyStoreException {
    if (keyAlias.equals(server.keyAlias)) {
        throw new IllegalArgumentException("The alias of client and server must be different!");
    }
    keystore.setCertificateEntry(server.keyAlias, server.getAliasCert());
    Certificate certificate = keystore.getCertificate(keyAlias);
    server.keystore.setCertificateEntry(keyAlias, certificate);
    return true;
}

• 只导入了单张证书，没导入完整链条：你调用setCertificateEntry时只传了单个Certificate对象，但TLS握手要求客户端发送从自身证书到根CA的完整链条。如果客户端密钥库只有自己的证书，缺了中间CA或根CA的证书，Java的SSL栈根本没法构建出完整的证书链发给服务器。
• 搞混了密钥库和信任库：你把客户端证书导入到了服务器的keystore（这是存服务器自己证书的地方），而不是truststore（用来验证客户端证书的信任库）。这不仅会让服务器没法信任客户端，还会让客户端这边的证书链逻辑出问题。

二、为什么本地检查有证书链，握手时却发不出去？ #

你本地检查可能只是确认了客户端密钥库里有自己的证书，但Java SSL构建证书链时，会自动去密钥库和信任库里找缺失的上级CA证书。如果你的客户端密钥库只有自己的证书，没有对应的中间CA或根CA，SSL栈凑不出完整链条，自然就会在握手时发送空的证书链。

另外，也有可能服务器的SSL配置没开启强制客户端认证？不过从日志里的ServerHelloDone之后服务器等待客户端证书来看，应该是开了的，问题还是出在证书链本身。

三、具体修复步骤 #

1. 修正证书导入逻辑，导入完整证书链 #

不管是客户端还是服务器，都得确保密钥库/信任库里有完整的证书链：

• 客户端密钥库：存客户端私钥+完整证书链（自己的证书→中间CA→根CA）
• 服务器信任库：存客户端的完整证书链（至少要有根CA，最好全链条都存）

修改你的方法，改成导入证书数组而非单张证书：

// 假设Party类有getAliasCertChain()方法返回完整的证书链数组
public boolean linkToServerCertificate(Party server) throws KeyStoreException {
    if (keyAlias.equals(server.keyAlias)) {
        throw new IllegalArgumentException("The alias of client and server must be different!");
    }
    // 把服务器的完整证书链导入客户端信任库
    Certificate[] serverCertChain = server.getAliasCertChain();
    keystore.setCertificateEntry(server.keyAlias, serverCertChain[0]);
    // 顺便把服务器的中间CA/根CA也导入，确保客户端能信任服务器
    for (int i = 1; i < serverCertChain.length; i++) {
        keystore.setCertificateEntry("server-ca-" + i, serverCertChain[i]);
    }
    
    // 把客户端的完整证书链导入服务器的信任库（注意是truststore，不是keystore！）
    Certificate[] clientCertChain = keystore.getCertificateChain(keyAlias);
    server.truststore.setCertificateEntry(keyAlias, clientCertChain[0]);
    for (int i = 1; i < clientCertChain.length; i++) {
        server.truststore.setCertificateEntry("client-ca-" + i, clientCertChain[i]);
    }
    return true;
}

2. 确保服务器的信任库配置正确 #

服务器的JVM参数里要明确指定信任库的路径和密码，不然服务器找不到信任的客户端证书：

# 替换成你自己的信任库路径和密码
JAVA_OPTS="-Djavax.net.ssl.trustStore=/path/to/server-truststore.jks -Djavax.net.ssl.trustStorePassword=your-truststore-pass -Djavax.net.debug=ssl"

3. 验证客户端密钥库的证书链完整性 #

用keytool命令检查一下客户端密钥库的证书链：

keytool -list -v -keystore client-keystore.jks -alias your-client-alias

输出里要能看到Certificate chain length: X，X至少是2（自己的证书+根CA），如果是1，说明缺了上级CA证书，得把对应的CA证书导入进去。

4. 确认服务器开启了强制客户端认证 #

比如Tomcat的话，要在server.xml的SSL连接器里设置clientAuth="true"，这样服务器才会在握手时主动请求客户端证书，客户端才会发送证书链。

四、调试验证 #

改完之后重启服务器，再开着-Djavax.net.debug=ssl参数看日志，如果正常的话，你会看到客户端发送的证书链信息：

*** Certificate chain
chain[0] = [
[
Version: V3
Subject: CN=YourClient, OU=..., O=..., L=..., ST=..., C=...
...
]
chain[1] = [
[
Version: V3
Subject: CN=YourCA, OU=..., O=..., L=..., ST=..., C=...
...
]
...

这就说明证书链已经正常发送了，握手应该就能成功完成了。

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