WSO2 Micro Integration 4.1 Socket Hang Up及超时问题求助

问题详情 #

STATE_DESCRIPTION = Socket Timeout occurred after accepting the request headers and the request body, INTERNAL_STATE = REQUEST_DONE, DIRECTION = REQUEST, CAUSE_OF_ERROR = Connection between the client and the EI timeouts, HTTP_URL = /api/v1/test, HTTP_METHOD = POST, SOCKET_TIMEOUT = 180000, CLIENT_ADDRESS = /127.0.0.1:52694

Postman返回 Error: socket hang up，已配置 passthru-http.properties 中的 http.connection.disable.keepalive=true 但问题未解决。

排查与解决方案 #

1. 调整全局请求超时参数 #

控制台显示的 SOCKET_TIMEOUT=180000（300秒）是默认请求处理超时，若后端服务响应耗时超过该值会触发超时。修改 <MI_HOME>/conf/passthru-http.properties 中的参数：

• http.socket.timeout：增大至业务允许的最大值（例如 300000 即500秒），覆盖默认180秒限制
• http.connection.timeout：调整连接建立超时（例如 60000 即60秒），确保后端能在规定时间内完成连接

修改后重启WSO2 MI服务。

2. 为API/代理服务配置专属超时 #

若你的API通过HTTP Sender调用后端，需在API/代理的配置中显式设置超时属性，避免全局配置不生效：

<property name="CLIENT_API_NIO" value="true" scope="axis2"/>
<property name="http.socket.timeout" value="300000" scope="axis2"/>
<property name="http.connection.timeout" value="60000" scope="axis2"/>

将上述属性添加到API的 inSequence 或代理服务的对应序列中，确保请求到后端的超时规则匹配实际业务需求。

3. 排查后端服务状态 #

Socket Timeout大概率是后端服务响应缓慢或未正常返回导致：

• 直接调用后端接口，确认是否能在合理时间内返回响应
• 检查后端服务日志，排查是否存在报错、线程阻塞或资源（CPU/内存）不足的情况

4. 优化连接池配置 #

并发请求过多时，连接池资源耗尽也会引发超时。调整 passthru-http.properties 中的连接池参数：

• http.connection.max.active：增大最大活跃连接数（例如从默认200调整为500）
• http.connection.max.idle：调整最大空闲连接数，匹配业务并发量

5. 开启调试日志定位根因 #

启用WSO2 MI的HTTP传输日志，查看请求完整流程：
修改 <MI_HOME>/conf/log4j2.properties，添加或调整：

logger.http-transport.name = org.apache.synapse.transport.http
logger.http-transport.level = DEBUG
logger.http-transport.additivity = false
logger.http-transport.appenderRef.CARBON_CONSOLE.ref = CARBON_CONSOLE

重启服务后发送请求，通过详细日志确认超时发生在请求接收、后端调用还是响应返回阶段。

6. 检查Postman本地设置 #

Postman自身的超时限制也可能导致 socket hang up：

• 进入Postman设置（Settings）→ General，增大 Request timeout 的值（例如设为300秒）
• 关闭 SSL certificate verification 选项，排除证书相关的连接异常

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