Golang gRPC客户端报http2: frame too large错误如何解决？

1. 修复CA证书配置 #

你代码里的caCert变量只有证书首尾标记，没有实际的证书内容。如果服务器使用自定义CA签发的证书，客户端必须把完整的CA证书内容填到caCert的首尾标记之间，这样根证书池才能正确验证服务器证书：

caCert := `-----BEGIN CERTIFICATE-----
// 填入完整的CA证书内容，例如：
MIIC5zCCAc+gAwIBAgIUY...（省略实际证书内容）
-----END CERTIFICATE-----`

如果之前用grpcurl是加了--insecure参数跳过TLS验证成功的，可以临时把getTransportCredential的参数改成true，先确认是不是TLS配置的问题：

conn, err := grpc.DialContext(ctx, serverAddr, grpc.WithBlock(), grpc.WithReturnConnectionError(), getTransportCredential(true))

如果这样能连接成功，就说明问题出在TLS证书配置上。

2. 指定正确的服务器名称 #

创建TLS凭证时，NewClientTLSFromCert的第二个参数是服务器证书的CN（通用名称）。如果你的serverAddr是IP地址，但服务器证书的CN是域名，必须显式指定这个参数，否则TLS握手会失败，错误可能被包装成HTTP2帧过大的提示：

creds := credentials.NewClientTLSFromCert(rootCAs, "your-server-domain.com")

3. 调整消息接收限制或HTTP2帧大小 #

如果服务器发送的初始帧超过了gRPC客户端的默认限制，可以通过两种方式调整：

方式一：设置gRPC最大接收消息大小 #

在DialContext中添加grpc.WithDefaultCallOptions，增大最大接收消息的限制值：

conn, err := grpc.DialContext(ctx, serverAddr, 
    grpc.WithBlock(), 
    grpc.WithReturnConnectionError(), 
    getTransportCredential(false),
    grpc.WithDefaultCallOptions(grpc.MaxRecvMsgSize(32*1024*1024)), // 设置为32MB，根据实际情况调整
)

方式二：自定义HTTP2连接配置 #

通过自定义拨号器设置HTTP2的最大读取帧大小：

import (
    "net"
    "golang.org/x/net/http2"
)

conn, err := grpc.DialContext(ctx, serverAddr, 
    grpc.WithBlock(), 
    grpc.WithReturnConnectionError(), 
    getTransportCredential(false),
    grpc.WithContextDialer(func(ctx context.Context, addr string) (net.Conn, error) {
        tcpConn, err := (&net.Dialer{}).DialContext(ctx, "tcp", addr)
        if err != nil {
            return nil, err
        }
        // 设置HTTP2最大帧大小为2MB，可根据服务器配置调整
        h2Conn, err := http2.ClientConnConfig{
            MaxReadFrameSize: 2 * 1024 * 1024,
        }.NewClientConn(tcpConn)
        if err != nil {
            tcpConn.Close()
            return nil, err
        }
        return h2Conn, nil
    }),
)

4. 对齐grpcurl的调用配置 #

检查你用grpcurl成功调用时的参数，比如是否指定了--cacert加载CA证书，或者用了--insecure跳过验证，把这些配置同步到Go客户端里就能解决问题。

内容的提问来源于stack exchange，提问作者noob-dev