HTTP DELETE |

概述

DELETE 用于请求服务器删除指定资源（RESTful 风格），是 HTTP 四种常见方法中最「轻」的一种——通常不需要请求体，资源位置写在路径（URL）里。设备注销、删除云端记录、移除数据点都可用 DELETE。本教程演示：向 httpbin.org/delete 发起 DELETE 请求，服务器回显本次请求信息。

用大白话讲：DELETE 就是告诉服务器「把 XX 删掉」——像给服务员说「这道菜撤了」。要删的东西写在「路径」里（比如 /devices/1001 就是删 1001 号设备），通常不用递单子（无请求体），服务器收到后回一句「删好了」（200 OK）。

本教程基于安信可官方 SDK（Ai-Thinker-Open/Ai-Thinker-WB2，版本 release_bl_iot_sdk_1.6.40）。
⚠️ 官方 SDK 未提供独立的 DELETE 示例工程。本教程以官方示例 applications/protocols/http_client_socket（GET 版）为基础改造，改动点仅请求报文（方法行），其余代码与官方一致，代码中已用注释标注。

🎯本页目标在官方 GET 示例基础上构造 DELETE 请求报文并验证服务器回显，掌握无 body 方法的报文构造。

🧰前置条件① Ai-WB2 开发板一块（Type-C 数据线）② 2.4GHz 路由器（能访问公网）③ 已按 [SDK 安装](../sdk/sdk_intro) 完成环境搭建，并完成 [连接 Wi-Fi](./wifi_connect) 与 [HTTP GET](./http_get)。

🔗相关章节更新资源见 [HTTP PUT](./http_put)；提交数据见 [HTTP POST](./http_post)。

①

进入示例工程

官方没有 DELETE 专用工程，直接使用官方 http_client_socket 工程改造：

cd ~/Ai-Thinker-WB2/applications/protocols/http_client_socket

说明：cd 是「进入目录」的命令，进入官方示例工程；后面所有 make 命令都要在这个目录下执行。

💡 复制一份目录（如 http_client_delete）再修改，保留官方工程原样。

②

修改路由器参数与目标地址

打开 http_client_socket/main.c，修改开头的 SSID/密码（官方默认是 AIOT@FAE，需改成自己的路由器）。

打开 http_client_socket/demo.c，修改目标服务器：

#define WEB_SERVER "httpbin.org"
#define WEB_PORT "80"
#define WEB_PATH "/delete"

💡 httpbin.org/delete 是免费的 DELETE 测试接口，收到请求会以 JSON 回显。真实业务中路径常携带资源 ID，如 DELETE /devices/1001。

③

编写代码（改造点：请求报文）

在官方 demo.c 基础上改造请求报文为 DELETE，本步完整代码已移至文末，见：

📜 完整代码 — 位于本页「完整代码」章节，默认折叠，点击展开，与官方示例（applications/protocols/http_client_socket/http_client_socket/demo.c）一致，仅请求报文按本页改造为 DELETE。

代码要点（与官方 GET 版的差异）：

改动点	说明
`DELETE /delete HTTP/1.0`	方法行 `GET` → `DELETE`（唯一改动），服务器靠它知道要删资源
无请求体	通常不需要 body，报文以空行（`\r\n\r\n`）结尾，多传反而可能出错
其余代码	与官方 http_client_socket 完全一致

💡 四种方法的报文差异：GET/DELETE 无请求体（资源在路径上）；POST/PUT 携带请求体（Content-Type + Content-Length + body）。服务器完全靠方法行 + 路径判断对资源做什么操作。

④

编译工程

在工程目录执行编译：

make -j8

说明：make 是「编译」命令，把代码变成开发板能运行的固件（烧进开发板的程序）；-j8 表示用 8 个 CPU 核并行编译，更快。

编译成功后生成固件 build_out/http_client_socket.bin。

⑤

烧录固件

开发板保持 USB 连接，确认串口设备号后执行烧录：

make flash p=/dev/ttyUSB0 b=921600

说明：make flash 是「烧录」命令，把编译好的固件下载进开发板；p= 后面是串口设备号（Linux 下常为 /dev/ttyUSB0，Windows 下是 COM3 之类，以你电脑实际为准），b=921600 是烧录波特率（串口传数据的速度），保持默认即可。

⏳ 烧录过程中按提示长按开发板 EN 键进入下载模式，等待进度条完成即烧录成功。

⑥

运行验证

烧录完成后开发板自动重启运行，串口（波特率 921600，串口传数据的「语速」，两边必须一致）打印连接日志后，输出 httpbin.org 的 JSON 回显：

DNS lookup succeeded. IP=34.224.xxx.xxx
... connected
... socket send success
HTTP/1.1 200 OK
Content-Type: application/json
...
{
  "args": {},
  "data": "",
  "origin": "116.xxx.xxx.xxx",
  ...
}
... done reading from socket. Last read return=0 errno=0

出现 HTTP/1.1 200 OK 且回显 "data": "" 即 DELETE 成功——这表示服务器正确识别并处理了删除请求。如果只看到 GOT IP 而没出现回显，先确认开发板已联网（GOT IP）、电脑浏览器能打开 httpbin.org（目标服务器可达），见文末 FAQ。

💡 小结：至此四种常用 HTTP 方法（GET/POST/PUT/DELETE）的报文构造都已掌握——方法行决定操作、路径定位资源、可选 body 携带数据。真实项目建议使用 HTTP 客户端库（如官方 SDK 的 components/network/httpc 组件）或直接拼接报文（本系列做法），按接口文档组装即可。

代码执行流程

例程从启动到运行的完整流程如下（图中的循环箭头表示反复执行）：

本文 API 汇总

getaddrinfo(name, port, &hints, &res)

域名解析为 IP 地址链表。

参数：

name：域名或 IP 字符串，如 "httpbin.org"
port：端口字符串，如 "80"
hints：查询条件结构体（限定 IPv4 + TCP）
res：输出参数，解析结果链表指针

返回值：成功返回 0；失败返回负值错误码

freeaddrinfo(res)

释放解析结果。

参数：

res：getaddrinfo 返回的结果链表

返回值：无

socket(af, type, proto)

创建 TCP socket。

参数：

af：AF_INET（IPv4）
type：SOCK_STREAM（流式 TCP）
proto：传 0

返回值：成功返回 socket 描述符；失败返回 -1

connect(fd, addr, addrlen)

连接服务器。

参数：

fd：socket 描述符
addr：服务器地址（struct sockaddr*）
addrlen：地址长度

返回值：成功返回 0；失败返回负值错误码

write(fd, buf, len)

发送整个 HTTP 报文（含请求体）。

参数：

fd：socket 描述符
buf：请求报文缓冲区（请求行 + 头 + 空行 + body）
len：报文总长度

返回值：成功返回发送字节数；失败返回负值

read(fd, buf, len)

读取服务器响应。

参数：

fd：socket 描述符
buf：接收缓冲区
len：缓冲区长度

返回值：返回读取字节数；0 = 对端关闭；负值 = 出错

close(fd)

关闭连接。

参数：

fd：socket 描述符

返回值：成功返回 0；失败返回 -1

setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, len)

设置接收超时。

参数：

fd：socket 描述符
level：SOL_SOCKET
optname：SO_RCVTIMEO
tv：struct timeval 指针
len：sizeof(struct timeval)

返回值：成功返回 0；失败返回负值错误码

inet_ntoa(addr)

IP 地址转字符串。

参数：

addr：网络字节序 IP

返回值：点分十进制字符串

bl_putchar(c)

逐字符输出到串口。

参数：

c：要输出的字符

返回值：无

📌 DELETE 报文 = 请求行（DELETE 路径 HTTP/1.0）+ 头 + 空行，无请求体。若接口需要携带条件信息，可放在路径（/devices/1001）或请求头中。

完整代码

以下为 demo.c 完整源码，与官方示例（applications/protocols/http_client_socket/http_client_socket/demo.c）一致，仅请求报文按本页改造为 DELETE：

📜 点击展开 demo.c 完整代码

#include <stdio.h>
#include <FreeRTOS.h>
#include <task.h>
#include <lwip/sockets.h>
#include <lwip/netdb.h>
#include <lwip/tcp.h>
#include <lwip/err.h>
#include <http_client.h>
#include <cli.h>
#include "demo.h"
#include <blog.h>

#define WEB_SERVER "httpbin.org"
#define WEB_PORT "80"
#define WEB_PATH "/delete"

/* ★ 改造点：方法 GET → DELETE（无请求体，报文以空行结尾） */
static const char *REQUEST = "DELETE " WEB_PATH " HTTP/1.0\r\n"
                         "Host: " WEB_SERVER ":" WEB_PORT "\r\n"
                         "User-Agent: aithinker wb2\r\n"
                         "\r\n";

void http_get_task(void *pvParameters)
{
const struct addrinfo hints = {
    .ai_family = AF_INET,
    .ai_socktype = SOCK_STREAM,
};
struct addrinfo *res;
struct in_addr *addr;
int s, r;
char recv_buf[4096];

while (1)
{
    int err = getaddrinfo(WEB_SERVER, "80", &hints, &res);

    if (err != 0 || res == NULL)
    {
        blog_error("DNS lookup failed err=%d res=%p", err, res);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
        continue;
    }

    addr = &((struct sockaddr_in *)res->ai_addr)->sin_addr;
    blog_info("DNS lookup succeeded. IP=%s", inet_ntoa(*addr));

    s = socket(res->ai_family, res->ai_socktype, 0);
    if (s < 0)
    {
        blog_error("... Failed to allocate socket.");
        freeaddrinfo(res);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
        continue;
    }
    blog_info("... allocated socket");

    if (connect(s, res->ai_addr, res->ai_addrlen) != 0)
    {
        blog_error("... socket connect failed errno=%d", errno);
        close(s);
        freeaddrinfo(res);
        vTaskDelay(4000 / portTICK_PERIOD_MS);
        continue;
    }

    blog_info("... connected");
    freeaddrinfo(res);

    if (write(s, REQUEST, strlen(REQUEST)) < 0)
    {
        blog_error("... socket send failed");
        close(s);
        vTaskDelay(4000 / portTICK_PERIOD_MS);
        continue;
    }
    blog_info("... socket send success");

    struct timeval receiving_timeout;
    receiving_timeout.tv_sec = 5;
    receiving_timeout.tv_usec = 0;
    if (setsockopt(s, SOL_SOCKET, SO_RCVTIMEO, &receiving_timeout,
                   sizeof(receiving_timeout)) < 0)
    {
        blog_error("... failed to set socket receiving timeout");
        close(s);
        vTaskDelay(4000 / portTICK_PERIOD_MS);
        continue;
    }
    blog_info("... set socket receiving timeout success");

    // FIXME fix putchar
    extern int bl_putchar(int c);

    /* Read HTTP response */
    do
    {
        bzero(recv_buf, sizeof(recv_buf));
        r = read(s, recv_buf, sizeof(recv_buf) - 1);
        for (int i = 0; i < r; i++)
        {
            bl_putchar(recv_buf[i]);
        }
    } while (r > 0);

    blog_info("... done reading from socket. Last read return=%d errno=%d\r\n", r, errno);
    close(s);
    for (int countdown = 10; countdown >= 0; countdown--)
    {
        blog_info("%d... ", countdown);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
    blog_info("Starting again!");
}
}

常见问题与踩坑提示

⚠️ 服务器返回 405 Method Not Allowed
原因：目标路径不支持 DELETE 方法（多数静态站点只支持 GET/HEAD）
解决：改用支持 DELETE 的接口（httpbin.org/delete、httpbin.org/anything）或自己的服务器

⚠️ 需要传参数但接口文档要求放 body
原因：部分后端 DELETE 也接受 body（非标准）
解决：按接口文档要求拼接（POST/PUT 章节的 Content-Type/Content-Length 写法同样适用）；标准做法优先放路径/请求头

⚠️ 误删了真实资源
原因：DELETE 是破坏性操作，测试接口与真实环境混淆
解决：开发阶段只用测试站点（httpbin.org）；对接真实服务器前先与后端确认接口语义与权限

⚠️ 其余问题（连不上路由器/DNS 失败/超时/栈溢出）
说明：与 HTTP GET 完全相同
解决：参照 HTTP GET 的踩坑提示处理（含连不上路由器、串口找不到、烧录失败等）

⚠️ 串口找不到设备 / 打不开
原因：USB 转串口驱动未装、权限不足，或数据线只能充电不能传数据
解决：Linux 用 lsusb/dmesg 查看设备，权限不足可 sudo chmod 666 /dev/ttyUSB0；Windows 装驱动后到设备管理器查 COM 口；换一根能传数据的线

⚠️ 烧录一直等待 / 失败
原因：未进入下载模式、波特率不对、或串口号填错
解决：烧录时按提示长按 EN 键进入下载模式；确认 p=/dev/ttyUSB0 换成你实际的串口；换 USB 口或数据线重试

运行自检

串口输出 HTTP/1.1 200 OK 且 JSON 回显无数据，即 DELETE 请求验证通过。

遇到问题？

如有其他问题，请到统一的提问与讨论区：Ai-Thinker Discussions

Wi-Fi

TCP/IP 通讯

HTTP/S

BLE

开发者贡献

快速入门

环境搭建

编译烧录

外设驱动

通信联网

系统底层

Wi-Fi

TCP/IP 通讯

HTTP/S

BLE

快速入门

环境搭建

编译烧录

外设驱动

通信联网

系统底层

概述

代码执行流程

本文 API 汇总

getaddrinfo(name, port, &hints, &res)

freeaddrinfo(res)

socket(af, type, proto)

connect(fd, addr, addrlen)

write(fd, buf, len)

read(fd, buf, len)

close(fd)

setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, len)

inet_ntoa(addr)

bl_putchar(c)

完整代码

常见问题与踩坑提示

TCP/IP 通讯

HTTP/S

快速入门

环境搭建

编译烧录

外设驱动

通信联网

系统底层

TCP/IP 通讯

HTTP/S

概述 ​

代码执行流程 ​

本文 API 汇总 ​

getaddrinfo(name, port, &hints, &res) ​

freeaddrinfo(res) ​

socket(af, type, proto) ​

connect(fd, addr, addrlen) ​

write(fd, buf, len) ​

read(fd, buf, len) ​

close(fd) ​

setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, len) ​

inet_ntoa(addr) ​

bl_putchar(c) ​

完整代码 ​

常见问题与踩坑提示 ​

概述

代码执行流程

本文 API 汇总

getaddrinfo(name, port, &hints, &res)

freeaddrinfo(res)

socket(af, type, proto)

connect(fd, addr, addrlen)

write(fd, buf, len)

read(fd, buf, len)

close(fd)

setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, len)

inet_ntoa(addr)

bl_putchar(c)

完整代码

常见问题与踩坑提示