Go crypto/tls设置最低 TLS 版本的配置边界

在 Go 项目里限制 TLS 版本，核心不是修改一个“安全开关”，而是明确连接两端最低接受哪个协议版本。客户端和服务端都可以通过 tls.Config.MinVersion 拒绝更低版本；如果只在一侧修改，另一侧的实际协商结果不会因此自动改变。对仍需兼容旧系统的服务，通常先把最低版本设为 TLS 1.2；能够确认所有对端都支持 TLS 1.3 时，再把边界收紧到 TLS 1.3。

先把最低版本和安全目标对齐

crypto/tls 当前公开的协议常量包括 VersionTLS12 和 VersionTLS13。设置 MinVersion 后，低于该值的协议不会参与协商；它不是“强制每次都使用某个版本”的写法。若还需要限制最高版本，才考虑配合 MaxVersion，但不要为了让测试通过而随意填两个互相矛盾的边界。

客户端要把 Config 传到真正发起连接的组件

HTTP 客户端常见的误区是创建了 tls.Config，却仍然使用默认 http.Transport。下面的写法把配置挂到自定义 Transport，再由 Client 使用；示例只演示版本边界，证书和超时策略仍应按项目补齐。

package main

import (
    "crypto/tls"
    "fmt"
    "net/http"
)

func newClient() *http.Client {
    // 只接受 TLS 1.2 及以上，兼容仍使用 TLS 1.2 的维护中上游。
    tlsConfig := &tls.Config{MinVersion: tls.VersionTLS12}
    transport := &http.Transport{
        // 让 HTTP 请求明确使用上面的版本边界。
        TLSClientConfig: tlsConfig,
    }
    return &http.Client{Transport: transport}
}

func main() {
    client := newClient()
    response, err := client.Get("https://example.com")
    if err != nil {
        // 不通过降低 MinVersion 掩盖握手失败，先保留原始错误。
        panic(err)
    }
    defer response.Body.Close() // 释放响应体，便于连接复用。
    fmt.Println(response.StatusCode)
}

如果项目直接使用 tls.Dial 或自定义拨号器，同样要把这份 Config 传给实际调用点。配置项写对但没有进入连接路径，表现上就像“MinVersion 不生效”。

服务端与连接状态的核对边界

服务端可以把配置交给 tls.Listen，或在已有网络连接上使用 tls.Server。握手成功后，ConnectionState().Version 是核对实际协商版本的直接入口；它回答的是“这次连接用了什么版本”，不是“配置文件里写了什么”。

cfg := &tls.Config{
    // 服务端拒绝低于 TLS 1.2 的客户端握手。
    MinVersion: tls.VersionTLS12,
}

conn := tls.Server(rawConn, cfg)
if err := conn.Handshake(); err != nil {
    // 对端不支持最低版本时，应记录握手错误并按兼容矩阵处理。
    return err
}
state := conn.ConnectionState()
fmt.Println(tls.VersionName(state.Version)) // 例如 TLS 1.2 或 TLS 1.3
defer conn.Close() // 关闭 TLS 连接及其底层资源。

迁移时别把版本下限当成全部 TLS 策略

收紧 MinVersion 后，最先受影响的是仍只支持 TLS 1.0/1.1 的旧客户端、代理或上游。错误信息可能来自协议版本不匹配，也可能来自证书链、SNI、主机名验证或网络中间层，因此不要看到握手失败就直接把下限降回去。更稳妥的迁移清单是：列出真实对端；分别验证 TLS 1.2 和 TLS 1.3；记录失败发生在客户端、网关还是服务端；最后再决定全局收紧或保留隔离例外。

还要注意 tls.Config 的复用边界。配置一旦被连接使用，就不应并发修改；需要派生不同策略时，创建独立配置或使用 Clone 后再调整。版本下限解决的是协议协商范围，证书验证、密钥材料、超时、代理和连接池仍要单独负责。

常见问题

MinVersion 设置为 TLS 1.3 后，TLS 1.2 为什么连不上？

这是预期结果。最低版本是 TLS 1.3 时，TLS 1.2 对端会在版本协商阶段被拒绝，应先确认对端矩阵，再决定是否恢复到 TLS 1.2。

只给 http.Client 设置 TLS 配置可以吗？

不能直接给 Client 填一个未使用的 Config。应把它放进实际 Transport 的 TLSClientConfig，或传给实际调用的 TLS 拨号函数。

MinVersion 能解决证书校验问题吗？

不能。它只限制协议版本下限；证书链、主机名、信任根和客户端认证仍由其他 TLS 配置与验证流程负责。

Go 官方 crypto/tls 文档列出了 TLS 1.2、TLS 1.3 常量以及 Config、ConnectionState 的接口。遇到兼容性问题时，优先对照当前官方文档和真实对端能力，再调整版本边界。