ESP32项目自定义分区表构建失败求助（ESP-IDF v5.4.1）

问题原因 #

1. OTA分区大小未对齐4KB：报错明确指出Size 0x1ce800 is not aligned to 0x1000——1850KB换算为字节是1894400，十六进制为0x1CE800，并非4KB（0x1000）的整数倍，ESP-IDF强制要求APP分区必须对齐到4KB边界。
2. 分区表格式错误：otadata和phy_init分区缺失Size字段，且Offset设置不合理（例如otadata的0x2000落在bootloader预留区域，会引发地址冲突）。

修复步骤 #

1. 调整OTA分区大小为4KB整数倍 #

将ota_0和ota_1的大小改为4KB的整数倍，比如：

• 1848KB（十六进制0x1CE000，满足0x1CE000 % 0x1000 = 0）
• 或1852KB（十六进制0x1CF000）

2. 修正分区表的Offset与Size字段 #

确保所有分区地址不重叠、字段完整，以下是适配4MB Flash的正确分区表示例：

# ESP-IDF Partition Table                   
# Name     Type  SubType     Offset   Size   Flags
nvs       data   nvs         0x9000   0x6000    
otadata   data   ota         0xF000   0x2000    
phy_init  data   phy         0x11000  0x1000    
ota_0     app    ota_0       0x12000  0x1CE000  
ota_1     app    ota_1       0x1E0000 0x1CE000  

3. 重新构建项目 #

执行清理后重新构建：

idf.py clean
idf.py build

额外验证 #

可以用ESP-IDF自带工具提前验证分区表合法性：

python $IDF_PATH/components/partition_table/gen_esp32part.py --verify partitions.csv

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