Apache APISIX 管理API连接被重置问题排查与解决

在使用Apache APISIX进行路由配置时，开发者可能会遇到通过curl调用管理API时出现"Connection reset by peer"的错误。本文将详细分析这一问题的原因，并提供完整的解决方案。

问题现象

当开发者尝试使用curl命令向APISIX的管理接口(默认端口9180)发送PUT请求创建路由时，连接被意外重置：

curl -vvvvv -i "http://127.0.0.1:9180/apisix/admin/routes" -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" -X PUT -d '{
  "id": "getting-started-ip",
  "uri": "/ip",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "httpbin.org:80": 1
    }
  }
}'

返回错误信息：

Recv failure: Connection reset by peer
curl: (56) Recv failure: Connection reset by peer

问题原因分析

经过排查，发现问题的根本原因是APISIX容器中的管理API功能被禁用了。在APISIX的配置文件中，enable_admin参数被设置为false，这导致管理接口无法响应请求，从而触发了连接重置。

解决方案

要解决这个问题，需要修改APISIX的配置文件，确保管理API功能被正确启用：

1. 找到APISIX的配置文件(通常是config.yaml)
2. 将enable_admin参数的值从false改为true
3. 重启APISIX服务使配置生效

修改后的配置示例：

apisix:
  enable_admin: true   # 确保此项为true
  node_listen: 9080    # APISIX监听端口
  enable_ipv6: false

验证解决方案

配置修改并重启服务后，可以通过以下方式验证管理API是否正常工作：

1. 检查APISIX容器状态是否正常运行
2. 再次尝试相同的curl命令，应该能够正常返回响应
3. 也可以通过访问http://127.0.0.1:9180/apisix/admin/routes来验证管理接口是否可用

总结

在使用APISIX时，管理API是进行路由配置等操作的重要接口。当出现连接被重置的情况时，首先应该检查管理API是否被正确启用。通过合理配置enable_admin参数，可以确保管理功能的正常使用，为后续的路由配置和API管理打下良好基础。

对于初次使用APISIX的开发者，建议在部署前仔细检查配置文件中的各项参数，特别是与核心功能相关的开关设置，以避免类似问题的发生。