ESP32-S3使用LittleFS出现损坏报错的排查及替代方案咨询

问题描述 #

在Arduino IDE中为ESP32-S3编写搭载LittleFS的程序时，出现LittleFS损坏报错，相同代码在ESP32-WROOM-32上可正常运行。

测试代码 #

#include <EEPROM.h>
#include <DNSServer.h>
#include <HTTPClient.h>
#include <HTTPUpdate.h>
#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <WebServer.h>
#include <LittleFS.h>
#include <ArduinoJson.h>
void setup() {
  if (!LittleFS.begin()) {
      Serial.println("LittleFS mount failed, formatting...");
      if (LittleFS.format()) {
          Serial.println("LittleFS formatted successfully.");
          if (LittleFS.begin()) {
              Serial.println("LittleFS mounted successfully.");
          } else {
              Serial.println("Failed to mount LittleFS after formatting.");
          }
      } else {
          Serial.println("Failed to format LittleFS.");
      }
  } else {
      Serial.println("LittleFS mounted successfully.");
  }
}

输出日志 #

ESP-ROM:esp32s3-20210327
Build:Mar 27 2021
rst:0x1 (POWERON),boot:0x8 (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fce3818,len:0x109c
load:0x403c9700,len:0x4
load:0x403c9704,len:0xb50
load:0x403cc700,len:0x2fd0
entry 0x403c98ac
E (4444) esp_littlefs: ./managed_components/joltwallet__littlefs/src/littlefs/lfs.c:1369:error: Corrupted dir pair at {0x0, 0x1}
E (4445) esp_littlefs: mount failed, (-84)
E (4448) esp_littlefs: Failed to initialize LittleFS
E (9188) task_wdt: esp_task_wdt_reset(763): task not found

排查方法 #

• 检查LittleFS分区配置：ESP32-S3的Flash分区表与ESP32-WROOM-32存在差异，在Arduino IDE的工具 > 分区方案中，选择包含LittleFS的分区（如“Default with LittleFS”），或自定义分区表确保LittleFS分区的起始地址和大小配置正确。
• 更新ESP32核心库：旧版本ESP32 Arduino核心对ESP32-S3的LittleFS支持存在bug，在Arduino IDE库管理器中搜索“ESP32”，更新至最新核心库版本。
• 强制全擦除Flash：使用esptool.py执行全擦除命令，清除Flash中残留的旧分区或损坏数据，命令如下：

  esptool.py --chip esp32s3 erase_flash
  

  擦除完成后重新上传程序及LittleFS文件（若有）。
• 验证Flash硬件兼容性：部分ESP32-S3模块的Flash芯片可能与LittleFS默认配置不兼容，可更换模块测试，或在代码中指定Flash的SPI模式（如QIO）和频率。
• 优化格式化逻辑：在代码中格式化LittleFS后添加短暂延时（如delay(100)），再执行LittleFS.begin()，避免Flash操作未完成就触发挂载。

替代方案 #

• 使用SPIFFS：SPIFFS是ESP32官方支持的轻量文件系统，API与LittleFS兼容，兼容性更强，适合对性能要求不高的场景。只需将代码中的LittleFS替换为SPIFFS，并选择对应SPIFFS分区方案即可。
• 使用FatFS：若需要支持大文件或复杂文件操作，可采用FatFS文件系统，通过SD卡或Flash模拟实现，适合需兼容标准文件系统的场景。
• 自定义分区表：若必须使用LittleFS，可编写自定义分区表，明确指定LittleFS分区的起始地址和大小，匹配ESP32-S3的Flash布局，再在Arduino IDE中选择该自定义分区表上传。

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