本地运行Temporal应用遇io.grpc超时异常，求排查根因

客户端超时配置核查 #

• 检查Temporal客户端初始化时的WorkflowClientOptions配置，重点看setRpcTimeout、setWorkflowRunTimeout这类超时参数，确认是否设置过短，导致请求尚未发起就触发超时。
• 排查业务代码中是否手动为gRPC CallOptions设置了过短的deadline，比如在调用服务Stub时自定义了超时时间。

本地Temporal服务状态验证 #

• 确认本地Temporal集群的Frontend、History、Matching、Worker所有组件是否正常启动，无端口占用或服务崩溃情况。
• 查看Temporal服务日志，排查是否存在内部延迟问题，比如数据库连接缓慢、任务队列阻塞等导致服务响应滞后。

网络与端口连通性检查 #

• 验证客户端配置的Temporal服务地址是否正确（本地开发通常为localhost:7233），确认端口未被其他程序占用。
• 使用telnet localhost 7233或nc -zv localhost 7233测试端口连通性，排除网络层面的阻塞问题。

工作流/活动代码阻塞排查 #

• 检查工作流或活动代码中是否存在长时间阻塞操作（如同步IO、未终止的循环），这类操作会导致客户端等待响应超时。
• 查看Worker进程的CPU、内存占用情况，确认是否因资源不足导致处理速度缓慢。

gRPC层面调试 #

• 开启gRPC详细日志，启动客户端时添加JVM参数：-Dgrpc.debug=true -Dgrpc.trace=true，通过日志定位请求发送时间与超时触发时间的间隔，判断是请求未发送还是服务未响应。
• 排查是否存在自定义gRPC拦截器修改了请求的deadline设置。

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