ESP32 S3自定义分区创建失败：ota_0偏移未对齐0x10000错误

问题原因 #

ESP32的**APP类型分区（包括factory、ota_0、ota_1）**强制要求起始偏移地址必须对齐到0x10000（64KB），这是Flash擦除块大小和bootloader加载机制的硬性要求。你的分区表中factory分区的结束地址（0x10000 + 0x1CCCCC = 0x1DCCCC）未对齐到0x10000，导致后续ota_0的起始地址同样不符合对齐规则，触发错误。

修正方案 #

调整所有APP分区的大小，确保每个APP分区的起始/结束地址都对齐到0x10000，同时适配8MB（0x800000）Flash的总容量。以下是修正后的分区表：

# Name,   Type, SubType,  Offset,   Size,  Flags
nvs,      data, nvs,      0x9000,   0x5000,
otadata,  data, ota,      0xe000,   0x2000,
factory,  app,  factory,  0x10000,  0x1C0000,
ota_0,    app,  ota_0,    0x1D0000, 0x1C0000,
ota_1,    app,  ota_1,    0x390000, 0x1C0000,
eeprom,   data, 0x99,     0x550000, 0x1000,
ffat,     data, fat,      0x551000, 0x2AF000,

调整细节说明 #

• factory、ota_0、ota_1的大小改为0x1C0000（28个64KB块），确保每个分区的结束地址都是0x10000的倍数，后续分区的起始地址自然满足对齐要求。
• eeprom分区起始地址调整为0x550000（前三个APP分区结束后的第一个对齐地址），大小保持0x1000不变。
• ffat分区起始地址为0x551000，大小设为0x2AF000，刚好填满剩余的Flash空间（0x800000 - 0x551000 = 0x2AF000）。

验证方法 #

将修正后的分区表替换原文件，重新编译项目即可消除对齐错误。若需要自定义APP分区大小，只需保证每个APP分区的大小是0x10000的整数倍，且所有分区的总大小不超过8MB。

内容的提问来源于stack exchange，提问作者Miguel Tomás