加密客户端Hello配置不兼容怎么办

Go 加密客户端遇到 “Hello 配置不兼容” 时，先不要尝试把 ClientHelloInfo 当成客户端改包入口。标准库的客户端 Hello 由 tls.Config 相关字段共同决定，排查重点通常是 ServerName、TLS 版本、NextProtos、信任根和客户端证书是否与服务端策略对应。

官方文档：https://pkg.go.dev/crypto/tls

最短处理路径是：先让 ServerName 与访问主机和证书匹配，再确认版本范围；如果服务端要求 ALPN 或双向 TLS，继续检查 NextProtos 与客户端证书。ClientHelloInfo 只用于服务端回调观察客户端发来的信息，不负责在客户端组装任意 Hello。

先分清客户端配置与服务端 ClientHello 回调

这个问题最容易误判的地方是名字相似。客户端使用 tls.Config 配置要发送和接受的 TLS 约束；服务端的 GetCertificate 或 GetConfigForClient 回调则会收到一个 *tls.ClientHelloInfo，用来根据来访客户端选择证书或配置。两者处在连接的不同一侧，不能互相替代。

package main

import "crypto/tls"

func clientTLSConfig() *tls.Config {
	return &tls.Config{
		// ServerName 同时参与证书主机名校验，并作为客户端 SNI。
		ServerName: "api.example.com",
		// 先给出兼容的最低版本，不要为了绕过错误随意降到旧版本。
		MinVersion: tls.VersionTLS12,
		// 只有服务端支持其中之一时，ALPN 才会产生共同协议。
		NextProtos: []string{"h2", "http/1.1"},
	}
}

这里的域名只是示例占位符。若代码实际连接的是 IP 地址，却把 ServerName 写成另一个域名，SNI 和证书校验就可能同时出现偏差。若服务端没有 ALPN 要求，也不必为了“看起来完整”硬塞一个服务端不支持的协议名。

先检查 ServerName 与 TLS 版本

Config.ServerName 有两个容易被忽略的作用：客户端会用它做证书主机名校验，并在适用时把它放入 SNI。访问地址、SNI 和证书覆盖的主机名不一致时，错误经常被笼统地归到 Hello 不兼容，实际是身份边界没有对齐。

版本方面，客户端的 MinVersion 和 MaxVersion 共同限定可接受范围。排查时先记录服务端明确支持的版本，再收窄客户端配置；不要直接设置 InsecureSkipVerify 来掩盖证书或主机名问题，也不要把 TLS 版本错误当成网络超时。

func compatibleConfig(serverName string) *tls.Config {
	return &tls.Config{
		// 服务器证书的主机名必须覆盖这个值；它不是随便填的备注。
		ServerName: serverName,
		// 让客户端至少使用 TLS 1.2；如果服务端只接受 TLS 1.3，可继续收窄 MaxVersion。
		MinVersion: tls.VersionTLS12,
	}
}

检查 NextProtos、RootCAs 与客户端证书

如果版本和主机名都合理，下一层通常是协议协商与认证材料。NextProtos 表达客户端支持的应用层协议；服务端声明了不在这份列表里的强制 ALPN 时，连接可能在握手阶段失败。RootCAs 影响客户端如何验证服务端证书，而服务端要求双向 TLS 时，客户端还必须提供证书链和私钥。

package main

import (
	"crypto/tls"
	"fmt"
)

func describeTLS(conn *tls.Conn) error {
	state := conn.ConnectionState()
	// ConnectionState 只记录已建立连接的协商结果，不代替握手错误处理。
	fmt.Printf("version=%#x alpn=%q server=%q resumed=%t\n",
		state.Version, state.NegotiatedProtocol, state.ServerName, state.DidResume)
	return nil
}

客户端证书的缺失、证书链顺序错误或私钥不匹配，通常属于认证材料问题，不是通过修改 Hello 文本就能解决的。若服务端启用了客户端认证，应先确认 Certificates 或 GetClientCertificate 是否提供了可用链，再看服务端允许的客户端证书类型。

把不兼容问题压缩成一张速查表

如果确实需要观察服务端收到的 ClientHello，应该在服务端回调中读取 ClientHelloInfo 的字段；如果需要调整客户端行为，则回到客户端的 tls.Config。这条边界明确后，大多数“Hello 配置不兼容”都能落到一个具体字段或认证材料上。

常见追问

能不能直接修改 Go 标准库生成的 ClientHello？

标准库公开的是配置字段和回调边界，不提供把 ClientHello 当作任意字节包直接编辑的常规客户端接口。优先用 tls.Config 表达正式的兼容要求；只有在明确了解协议和维护代价时，才评估第三方实现。

为什么设置了 NextProtos 仍然协商不到目标协议？

NextProtos 只是客户端支持列表，最终仍取决于服务端是否启用 ALPN、是否接受共同协议以及上层连接是否真的使用了这份 tls.Config。先确认 Transport 或 Dialer 没有被另一份配置覆盖。