使用Here Maps Batch Geocode API流式处理结果时遇18分钟连接关闭错误求助

核心判断 #

18分钟的超时大概率是Here API端的固定配置限制，不是偶发故障，也基本不是你的代码问题。

具体分析 #

• Here Maps的Batch Geocode API针对长连接流式传输会设置全局超时阈值，18分钟是这类批量处理API常见的资源占用管控窗口——服务器会主动切断长时间未完成的请求，避免单个请求持续占用资源。
• 你遇到的peer closed connection without sending complete message body (incomplete chunked read)错误，是服务器主动终止连接的典型表现，和httpx异步客户端的stream.aiter_lines用法无关，只要你没在客户端设置更短的超时，就排除客户端配置问题。

可行解决方向 #

• 拆分任务：把大规模的批量请求拆成多个小批次，让每个批次的处理时间控制在18分钟以内，从根源上避免触发服务器超时。
• 启用传输压缩：虽然你现在用的是未压缩结果，但开启gzip压缩能大幅减少数据传输量，缩短整体流式处理时间，降低超时概率。
• 添加重连逻辑：在代码里实现断点续处理机制，当检测到连接中断时，根据已处理的行数/进度，重新发起请求并从断点处继续（如果Here API不支持断点续传，优先用拆分任务的方案）。
• 确认客户端超时：检查httpx异步客户端的timeout参数，确保没有设置比18分钟更短的超时（比如默认的5分钟），如果有就调大，但即使调大，服务器端的限制依然可能触发中断，所以这只是辅助手段。

内容的提问来源于stack exchange，提问作者d.a.d.a