Cloudflare配置ESDB证书后代码调用报DeadlineExceeded如何解决

1. 端口与Cloudflare配置校验 #

• Cloudflare默认仅对标准HTTPS 443端口的gRPC流量做透传，2113端口会被Cloudflare安全策略拦截，这是出现DeadlineExceeded错误的最常见原因。
• 进入Cloudflare域名后台的「网络」配置页，确认gRPC开关已开启，默认状态为关闭，未开启时所有gRPC流量会被直接丢弃。

2. Nginx反向代理配置校验 #

EventStoreDB gRPC通信依赖HTTP/2协议，普通HTTP反向代理配置无法支持，需确认Nginx配置满足以下要求：

• 443端口监听配置必须开启http2：listen 443 ssl http2;
• 转发指令必须使用grpc_pass而非普通的proxy_pass指向EventStoreDB的gRPC端口（默认为2113）
• 需补充gRPC头转发规则：

grpc_set_header Host $host;
grpc_set_header X-Real-IP $remote_addr;
grpc_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
grpc_set_header X-Forwarded-Proto $scheme;

3. 客户端连接字符串修正 #

当前三类连接字符串均存在问题，正确配置如下：

services.AddEventStoreClient("esdb://admin:changeit@esdb.megiservices.com:443?tls=true&tlsVerifyCert=true");

• 必须显式指定443端口，否则客户端会默认尝试连接2113端口被拦截
• 禁止直接用IP访问，证书的使用者备用名称（SAN）未包含IP时会触发TLS握手失败
• 若临时测试可添加tlsVerifyCert=false参数排除证书验证问题，生产环境必须开启证书验证

4. 依赖版本兼容校验 #

• 确认EventStoreDB服务端版本与客户端EventStore.Client.Grpc.Streams 20.10.0匹配，要求服务端版本≥20.10.0
• 当前使用的Grpc.Net.Client 2.38.0存在已知HTTP/2连接不稳定问题，建议升级至2.43.0及以上版本

内容的提问来源于stack exchange，提问作者Minh Mít