Go crypto/tls Config.MinVersion 如何限制握手版本

想让 Go 的 TLS 握手拒绝过低版本，直接设置 tls.Config.MinVersion。它表示“可接受的最低版本”，不是“强制使用的唯一版本”：例如设为 tls.VersionTLS12 后，TLS 1.2 和 TLS 1.3 仍都可能进入协商范围。只有把 MaxVersion 也设成同一个值，才能表达只允许一个版本的策略。

一、先分清 MinVersion 是下限不是指定版本

crypto/tls 用版本常量表达协议范围：VersionTLS12 是 TLS 1.2，VersionTLS13 是 TLS 1.3。MinVersion 非零时，低于它的候选版本会被排除；MaxVersion 非零时，高于它的候选版本会被排除。两端最后只能从交集里选择版本。

因此，下面的配置是“至少 TLS 1.2”，而不是“只用 TLS 1.2”。Go 1.22 起，客户端和服务端在未显式指定时默认最低版本已提高到 TLS 1.2；显式写出字段仍更利于审计和表达应用策略。

二、在客户端和服务端配置最低版本

客户端把配置交给 tls.Dialer、http.Transport 或显式的 tls.Client；服务端则把它交给 tls.Server 或 HTTP 服务器的 TLS 配置。最小写法如下：

package main

import "crypto/tls"

func tlsConfig() *tls.Config {
	return &tls.Config{
		// 只拒绝低于 TLS 1.2 的握手，TLS 1.3 仍可协商。
		MinVersion: tls.VersionTLS12,
	}
}

func tls13OnlyConfig() *tls.Config {
	return &tls.Config{
		// 上下限相同，才表示只接受 TLS 1.3。
		MinVersion: tls.VersionTLS13,
		MaxVersion: tls.VersionTLS13,
	}
}

客户端和服务端都要满足范围要求。比如客户端最低设为 TLS 1.3，而服务端只支持 TLS 1.2，证书即使正确，握手也会因没有共同版本而失败。配置交给 TLS 函数后不要再修改同一个 Config；需要不同策略时返回新的配置或使用 Clone。

三、需要只允许一个版本时同时设置 MaxVersion

可以把策略写成一个小表，避免把“最低版本”和“目标版本”混为一谈：

生产环境通常先采用“最低 TLS 1.2、上限交给库”的范围策略，以保留 TLS 1.3 的升级空间。只有协议兼容、合规或对端明确要求时，才把上下限收窄到同一个版本；收窄前要确认所有调用方都能支持。

四、用 ConnectionState 判断实际协商结果

配置只表示允许范围，实际使用的版本要在握手完成后读取连接状态。显式调用握手时，可按下面方式记录结果：

if err := conn.Handshake(); err != nil {
	// 版本没有交集时，先记录错误，不要把它误判成证书问题。
	return err
}

state := conn.ConnectionState()
// NegotiatedProtocol 是本次连接实际选中的 TLS 版本名称。
log.Printf("tls version=%s", state.NegotiatedProtocol)

排查时按三层看：先确认两端的 MinVersion/MaxVersion 没有把范围交集清空；再确认对端确实支持目标版本；最后再看证书、SNI、密码套件或代理设备等其他握手条件。不要仅凭 MinVersion: tls.VersionTLS13 就断言“已经使用 TLS 1.3”，成功握手后还应核对 ConnectionState。

常见问题

只设置 MinVersion 能禁止 TLS 1.3 吗？

不能。它只抬高下限；要禁止 TLS 1.3，应把 MaxVersion 设为 TLS 1.2。

MinVersion 设成 TLS 1.3 后握手失败怎么办？

先确认服务端和中间代理支持 TLS 1.3，再检查 MaxVersion 是否低于 MinVersion，最后读取原始握手错误。

怎么知道连接最终用了哪个版本？

在握手成功后读取 conn.ConnectionState()，以其中的协商版本字段为准。

判断口诀很简单：MinVersion 是下限，MaxVersion 是上限，实际版本看 ConnectionState。这样既能表达“拒绝旧版本”，也不会把允许范围误写成单一版本。