导语：主图只有 8 张却报“图片数量超限”——多 SKU 卖家几乎都踩过这个看似无解的坑。
为什么 8 张图能被算成十几张
用 ERP 上品时有个特别容易搞懵的报错：主图明明只有 8 张，平台却提示 “Items in category cannot exceed X pictures”（item.pictures.max）。第一反应是删主图，删到 6 张还报、5 张还报——问题可能根本不在主图。美客多官方 CBT FAQ 明确：系统计算图片数量不一定只数主图 pictures，Variation/变体里的图片也可能一起计入。比如一个 Listing 主图 8 张，红、黑、白三个 SKU 各配 3 张变体图，接口层面要同时处理主图加三组变体图，配置重复或结构不合理时，有效图片数就超过类目上限了。官方专门提醒：主图和变体图不要无意义重复配置。
各类目上限不一样
图片上限不是固定 10 张或 12 张：类目接口有两个字段——max_pictures_per_item（商品图片上限）和 max_pictures_per_item_var（每个变体图片上限），item.pictures.max 报错就是按这两个字段判断的。所以同一个 ERP 模板，A 类目能发、B 类目突然报图片超限，不一定是 ERP 坏了，可能就是两个类目允许的数量不同。
更坑的：没改图片也可能突然报超限
比如多 SKU 商品原有 A、B、C 三个变体，你今天只想改 A 的库存，ERP 更新时只提交了 A——如果接口把这次操作理解成“新的变体列表只有 A”，B、C 可能被隐式移除，平台重算 Listing 结构后图片约束也会重算，于是明明只改库存却突然报图片超限。官方 FAQ 建议变体更新时按完整结构读取、修改后整体写回，避免不完整更新把其他变体删掉。
五步排查顺序
看到 item.pictures.max 按顺序查：查当前类目图片上限 → 数主图 Pictures → 数每个 Variation 的图片 → 看同一张图有没有在主图和多个变体里重复提交 → 检查本次更新有没有把完整变体结构带回去。记住一句话：你看到的是前台 Listing，平台检查的是完整接口结构——多 SKU 商品报错时，别只盯着页面上看得见的内容。
结语：记住平台数的是完整接口结构：主图加全部变体图——按五步顺序排查，别再冤枉主图。
