如何使用ESP-IDF将HTML、favicon等二进制数据上传到ESP32的SPIFFS？

你当前同时配置了「文件嵌入固件」和「独立SPIFFS镜像」两种方案的规则，导致配置冲突，两种方案选其一即可，不要混用。 #

方案一：将资源文件直接嵌入固件（无需单独烧录SPIFFS分区） #

适用场景：资源文件较小，不想额外维护SPIFFS镜像烧录步骤
操作步骤：

• 删掉项目根目录CMakeLists.txt里你手动加的两行target_add_binary_data配置，PlatformIO的board_build.embed_txtfiles已经自动实现了对应功能，手动加的配置会冲突
• 确认platformio.ini中的board_build.embed_txtfiles配置路径正确（相对于项目根目录，你的data目录和src平级的话当前配置没问题）
• 代码中的符号名按照「路径所有非字母数字字符替换为下划线」的规则修改，正确的声明如下：

extern const unsigned char favicon_ico_start[] asm("_binary_data_favicon_ico_start");
extern const unsigned char favicon_ico_end[] asm("_binary_data_favicon_ico_end");
extern const unsigned char upload_script_start[] asm("_binary_data_upload_script_html_start");
extern const unsigned char upload_script_end[] asm("_binary_data_upload_script_html_end"); 

• 删掉项目的.pio缓存目录，重新编译即可解决链接错误

方案二：使用独立SPIFFS文件系统镜像（需单独烧录SPIFFS分区） #

适用场景：资源文件较多较大，后续可能单独更新资源无需重刷固件
操作步骤：

• 删掉platformio.ini中的board_build.embed_txtfiles配置项
• 删掉项目根目录CMakeLists.txt里你手动加的两行target_add_binary_data配置
• 在platformio.ini中添加一行配置指定文件系统类型：

board_build.filesystem = spiffs

• 确认你的自定义分区表中存在SPIFFS分区，分区大小大于data目录所有文件总大小
• 删掉代码里所有extern声明的资源符号，改为SPIFFS挂载后直接读文件的逻辑，示例逻辑如下：

// 初始化SPIFFS
esp_vfs_spiffs_conf_t conf = {
  .base_path = "/spiffs",
  .partition_label = NULL,
  .max_files = 5,
  .format_if_mount_failed = true
};
esp_vfs_spiffs_register(&conf);

// 读文件示例
FILE* f = fopen("/spiffs/favicon.ico", "r");

• 删掉项目的.pio缓存目录，先编译固件，再运行「Build Filesystem Image」和「Upload Filesystem Image」任务即可解决SPIFFS构建报错

SPIFFS构建报错额外排查 #

如果按方案二操作后仍提示data/favicon找不到：

• 确认data目录下的favicon文件后缀正确，确实为favicon.ico而非无后缀的favicon
• 检查是否有自定义构建规则错误引用了无后缀的favicon文件
• 全盘清理缓存后重新构建

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