ESP-IDF中httpd_uri_t如何匹配根目录下所有文件？

问题原因 #

ESP-IDF的HTTP服务器路由匹配不支持/*这种直接的通配符写法——它会把/*当作字面量路径匹配，只有请求/*本身时才会触发处理函数，自然无法匹配其他文件请求。

正确解决方案 #

推荐两种可行的实现方式：

方式一：前缀匹配+动态路径解析

注册以/为URI的路由，并开启HTTPD_URI_FLAG_MULTI标记，这样所有以/开头的请求都会进入处理函数，再在函数内解析具体请求路径，从SPIFFS读取对应文件。

示例代码：

#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "esp_http_server.h"
#include "esp_vfs.h"
#include "esp_spiffs.h"

static esp_err_t static_file_handler(httpd_req_t *req)
{
    const char *req_path = req->uri;
    // 请求根路径时默认返回index.html
    const char *file_path = strcmp(req_path, "/") == 0 ? "/index.html" : req_path;

    // 尝试从SPIFFS打开文件
    FILE *file = fopen(file_path, "r");
    if (!file) {
        httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, "File not found");
        return ESP_OK;
    }

    // 获取文件大小
    fseek(file, 0, SEEK_END);
    long file_size = ftell(file);
    fseek(file, 0, SEEK_SET);

    // 读取文件内容到缓冲区
    char *file_buf = malloc(file_size);
    if (!file_buf) {
        fclose(file);
        httpd_resp_send_err(req, HTTPD_500_INTERNAL_SERVER_ERROR, "Out of memory");
        return ESP_OK;
    }
    fread(file_buf, 1, file_size, file);
    fclose(file);

    // 根据文件后缀设置响应Content-Type
    if (strstr(file_path, ".html")) {
        httpd_resp_set_type(req, "text/html");
    } else if (strstr(file_path, ".css")) {
        httpd_resp_set_type(req, "text/css");
    } else if (strstr(file_path, ".js")) {
        httpd_resp_set_type(req, "application/javascript");
    }
    // 可按需添加图片、字体等其他类型的Content-Type

    // 发送文件内容
    httpd_resp_send(req, file_buf, file_size);
    free(file_buf);
    return ESP_OK;
}

// 注册路由
void register_static_file_handler(httpd_handle_t server)
{
    httpd_uri_t static_uri = {
        .uri       = "/",
        .method    = HTTP_GET,
        .handler   = static_file_handler,
        .user_ctx  = NULL,
        .flags     = HTTPD_URI_FLAG_MULTI  // 允许匹配所有以"/"开头的路径
    };
    httpd_register_uri_handler(server, &static_uri);
}

方式二：使用官方简化接口（更便捷）

ESP-IDF的esp_http_server提供了httpd_resp_send_file函数，可以直接在处理函数中发送SPIFFS文件，配合前缀路由同样能实现需求。

关键代码片段：

static esp_err_t static_file_handler(httpd_req_t *req)
{
    const char *file_path = strcmp(req->uri, "/") == 0 ? "/index.html" : req->uri;
    // 直接用httpd_resp_send_file发送SPIFFS文件，自动处理文件不存在的情况
    esp_err_t ret = httpd_resp_send_file(req, file_path, NULL);
    if (ret == ESP_ERR_NOT_FOUND) {
        httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, "File not found");
    }
    return ret;
}

// 路由注册同方式一，开启HTTPD_URI_FLAG_MULTI标记

注意事项 #

1. 确保SPIFFS已正确挂载，且data目录下的文件已烧录到设备中；
2. 文件路径要与SPIFFS中的实际路径一致（比如请求/style.css对应SPIFFS根目录下的style.css）；
3. 若有特殊后缀的文件，记得补充对应的Content-Type设置，避免浏览器无法正确解析。

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