RoadRunner项目中GRPC客户端过早关闭问题分析与解决方案

问题背景

在RoadRunner 2024.1.5版本中，当使用Temporal工作流引擎时，如果系统接收到SIGTERM信号进行优雅关闭，GRPC客户端连接会过早终止。这导致正在执行中的活动(Activity)虽然能够完成处理，但无法通过GRPC将结果返回给Temporal服务端。

问题现象

典型的现象是当执行一个耗时较长的活动（如HTTP请求）时，如果在活动完成前发送终止信号，虽然活动能够执行完毕，但会收到"grpc: the client connection is closing"的错误，无法将结果正确传回Temporal服务。

技术分析

从日志和代码分析可以看出，问题的核心在于RoadRunner的关闭顺序存在缺陷：

1. 当前实现中，当收到终止信号时，系统会立即关闭GRPC客户端连接
2. 但此时可能还有PHP工作进程正在处理Temporal活动任务
3. 这些工作进程完成任务后尝试通过已关闭的GRPC连接返回结果，导致失败

解决方案

正确的关闭顺序应该是：

1. 首先停止接收新的Temporal任务
2. 等待所有正在执行的PHP工作进程完成当前任务
3. 最后才关闭GRPC客户端连接

具体实现上需要：

1. 重构服务器插件的停止机制，移除中心化的池停止机制
2. 让各插件直接管理自己的工作进程池
3. 为Temporal插件实现特定的关闭顺序：先停止任务工作者，再停止PHP工作者，最后关闭客户端连接

影响与建议

这个问题主要影响使用RoadRunner运行长时间Temporal活动的场景。对于生产环境，建议：

1. 为关键业务流程设置合理的活动超时时间
2. 考虑实现活动结果的本地缓存和重试机制
3. 关注RoadRunner的后续版本更新，及时升级修复此问题

总结

GRPC客户端过早关闭问题是分布式系统中常见的资源生命周期管理挑战。RoadRunner作为高性能PHP应用服务器，在处理这类问题时需要特别注意各组件间的依赖关系和关闭顺序。通过合理的架构调整，可以确保系统在优雅关闭时仍能保持数据的完整性和一致性。