gRPC服务端心跳间隔不符配置问题：Node.js+Android Kotlin端咨询

我正在开发一个基于gRPC的项目，服务端采用Node.js实现，客户端为Kotlin编写的Android应用。目前已成功建立连接，服务端流式通信功能运行正常。但遇到异常问题：尽管已将保活时间设置为5分钟，通过Wireshark日志发现服务端仍每30秒向客户端发送心跳包。

服务端配置代码 #

const options = { 
  'grpc.keepalive_permit_without_calls': false, 
  "grpc.keepalive_time_ms": 300000 
}; 

客户端配置代码 #

val builder = ManagedChannelBuilder.forAddress(ipaddress, portno)
                .keepAliveTime(5, TimeUnit.MINUTES)
                .keepAliveWithoutCalls(false)
                .proxyDetector { null }
                .usePlaintext()
channel = builder.build() 

请问是否可以调整该心跳间隔？若可以，最大支持设置多长时间？需要进行哪些代码修改？

1. 是否可以调整心跳间隔？ #

可以调整。当前配置未生效是因为gRPC存在默认的保活兜底限制：Node.js服务端默认强制grpc.min_time_between_pings_ms为30秒，这个值会覆盖你设置的更长间隔，导致服务端仍按30秒发送心跳。

2. 最大支持设置多长时间？ #

gRPC本身没有严格的上限，但受限于中间网络设备（如NAT、防火墙）的超时策略——多数设备会在5-30分钟内断开无数据的连接，建议最大设置不超过30分钟，避免被中间设备主动断开连接。

3. 需要修改的代码 #

服务端（Node.js）

需额外配置grpc.min_time_between_pings_ms，将其设为大于等于grpc.keepalive_time_ms的值，同时补充心跳超时配置：

const options = { 
  'grpc.keepalive_permit_without_calls': false,
  'grpc.keepalive_time_ms': 300000, // 5分钟
  'grpc.min_time_between_pings_ms': 300000, // 必须≥keepalive_time_ms
  'grpc.keepalive_timeout_ms': 60000 // 1分钟，心跳未响应则判定连接异常
};

客户端（Android Kotlin）

同步配置心跳超时，同时设置最小保活间隔匹配服务端限制：

val builder = ManagedChannelBuilder.forAddress(ipaddress, portno)
                .keepAliveTime(5, TimeUnit.MINUTES)
                .keepAliveTimeout(1, TimeUnit.MINUTES) // 新增超时配置
                .keepAliveWithoutCalls(false)
                .minKeepAliveTime(5, TimeUnit.MINUTES) // 新增最小间隔，匹配服务端
                .proxyDetector { null }
                .usePlaintext()
channel = builder.build() 

关键注意点 #

• 必须保证服务端grpc.min_time_between_pings_ms ≥ grpc.keepalive_time_ms，否则服务端会强制使用最小间隔值。
• 客户端minKeepAliveTime不能小于服务端的grpc.min_time_between_pings_ms，否则客户端心跳请求会被服务端拒绝。

内容的提问来源于stack exchange，提问作者user