PocketBase实时订阅连接中断问题分析与解决方案

问题现象

在使用PocketBase的实时订阅功能时，开发者报告了一个典型问题：在几分钟不活动后，订阅连接会停止工作且不显示任何错误。这个问题在不同环境下表现不同：

• 在Raspberry Pi 5上的Docker容器中会出现
• Windows 10上的Docker容器中会出现
• Raspberry Pi 5本地运行时会出现
• 但Windows 10本地运行时却能正常工作

技术背景

PocketBase是一个开源的实时后端解决方案，它提供了实时订阅功能，允许客户端监听数据库变更。这项功能基于Server-Sent Events(SSE)技术实现，在Node.js环境中通常需要使用EventSource polyfill。

问题排查过程

环境配置检查

开发者提供了详细的配置信息：

1. 使用官方Dockerfile构建镜像
2. 通过docker-compose部署
3. Nginx作为反向代理，配置了长连接参数
4. 启用了开发模式(--dev)以便查看详细日志

日志显示连接确实会在5分钟空闲后被服务器主动关闭，但客户端没有按预期自动重连。

核心代码分析

问题代码中使用了EventSource polyfill来建立实时连接：

import { EventSource } from "eventsource";
global.EventSource = EventSource;

深入调查发现

经过多次测试和版本比对，发现问题可能与以下因素相关：

1. EventSource polyfill的版本差异
2. 运行时环境(Node.js/Bun)的特定行为
3. 底层操作系统对长连接的处理方式

根本原因

最终确定问题出在EventSource polyfill的版本上：

• 使用3.0.5版本时会出现连接中断后不重连的问题
• 降级到2.0.2版本后问题解决

解决方案

对于遇到类似问题的开发者，建议采取以下步骤：

1. 检查EventSource版本：确认使用的是稳定版本(如2.0.2)
2. 验证基础功能：先不使用polyfill，直接在浏览器中测试基本功能
3. 环境隔离测试：逐步排除Docker、反向代理等中间层的影响
4. 监控连接状态：利用PocketBase的--dev模式查看详细连接日志

最佳实践建议

1. 版本控制：对于关键依赖如EventSource，建议锁定版本
2. 错误处理：增强客户端代码的错误捕获和重连机制
3. 连接监控：实现客户端心跳检测，主动发现连接异常
4. 环境一致性：尽量保持开发、测试和生产环境的一致性

技术要点总结

1. PocketBase的实时订阅功能依赖稳定的SSE连接
2. Node.js环境需要合适的EventSource polyfill实现
3. 网络中间件(Docker/Nginx)的配置会影响长连接行为
4. 不同运行时(Node.js/Bun)对polyfill的支持可能存在差异

通过系统性的排查和验证，开发者可以快速定位和解决这类实时连接问题，确保应用稳定运行。