调用FitBit Subscriptions API创建订阅时返回Error: read ECONNRESET

我尝试调用FitBit Subscriptions API创建订阅，请求如下：

POST https://api.fitbit.com/1/user/-/activities/apiSubscriptions/1.json

但持续收到错误：

Error: read ECONNRESET

请求头详情：

content-length: 10000000
X-Fitbit-Subscriber-Id: fitbit-subscription-handler
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJhdWQiOiIyMzk5WUQiLCJzdWIiOiI4UTJLOFYiLCJpc3MiOiJGaXRiaXQiLCJ0eXAiOiJhY2Nlc3NfdG9rZW4iLCJzY29wZXMiOiJyZWNnIHJzZXQgcm94eSBybnV0IHJwcm8gcnNsZSByY2YgcmFjdCBycmVzIHJ3ZWkgcmhyIHJ0ZW0iLCJleHAiOjE2NzU0MTgxMzYsImlhdCI6MTY3NTM4OTMzNn0.-_307-4K00hU9fdcN86G0GcONpIYMmyxr8co5dZdaHE
User-Agent: PostmanRuntime/7.30.0
Accept: */*
Cache-Control: no-cache
Postman-Token: d3f2cf54-8d4c-4d81-92e0-5cc2608b5bdb
Host: api.fitbit.com
Accept-Encoding: gzip, deflate, br
Connection: keep-alive

问题分析 #

这个错误的核心原因是请求头里的content-length: 10000000完全不符合接口要求。FitBit创建订阅的POST接口不需要携带请求体，或者说请求体长度极小，而你设置的10MB长度会让服务器一直等待你发送数据，超时后服务器主动断开连接，从而触发ECONNRESET错误。

修复方案 #

• 直接移除请求头中的content-length字段，Postman会自动处理请求头（当没有请求体时，不会添加这个字段，或自动设为0）。
• 确认请求没有多余的请求体内容，创建FitBit订阅的接口无需发送任何请求体数据。
• 重新发送请求，验证订阅是否创建成功。

补充说明 #

ECONNRESET错误通常意味着网络连接被对方（服务器）主动重置，常见诱因包括请求格式非法、参数异常、服务器资源限制等。这里的异常content-length是最明确的触发点。

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