Amazon MWS PHP API GetFulfillmentPreviewItemList多SKU设置及数组覆盖问题

我之前也踩过MWS PHP API这个数组覆盖的坑，太懂这种明明数据都对但就是丢了一个商品的挫败感了！你的问题核心是多商品数组的构建格式不符合MWS SDK的要求，导致第二个商品直接覆盖了第一个，下面给你具体的解决步骤：

1. 检查Items.member的数组构建方式 #

MWS的PHP接口对多成员参数（比如多个商品）的处理，要求用索引数组而非重复的关联键赋值。你之前的写法大概率是这样的：

// ❌ 错误写法：重复赋值同一个键，直接覆盖
$order['Items.member'] = $item0;
$order['Items.member'] = $item1;

正确的做法是把Items.member定义为包含两个商品的索引数组：

// ✅ 正确写法1：直接初始化数组
$order['Items.member'] = [
    $item0,
    $item1
];

// ✅ 正确写法2：逐个追加元素
$order['Items.member'][] = $item0;
$order['Items.member'][] = $item1;

2. 用SDK对象的内置方法添加商品（推荐） #

如果你使用的是官方MWS PHP客户端的模型类（比如GetFulfillmentPreviewRequest、FulfillmentPreviewItem），不要直接手动构建数组，而是用SDK提供的方法来添加多个商品：

// 创建请求对象
$previewRequest = new GetFulfillmentPreviewRequest();

// 构建第一个商品
$item0 = new FulfillmentPreviewItem();
$item0->setSellerSKU('999938-0');
$item0->setQuantity(1);
// 其他必要属性赋值...

// 构建第二个商品
$item1 = new FulfillmentPreviewItem();
$item1->setSellerSKU('999938-1');
$item1->setQuantity(1);
// 其他必要属性赋值...

// 方式一：一次性传入商品数组
$previewRequest->setItems([$item0, $item1]);

// 方式二：逐个添加（更直观，适合动态添加商品的场景）
// $previewRequest->addItems($item0);
// $previewRequest->addItems($item1);

SDK的setItems方法会自动处理多成员的格式，避免覆盖问题；addItems方法则是逐个把商品追加到列表里，不会覆盖已有元素。

3. 调试验证请求结构 #

在发送请求前，打印出请求的数组或XML结构，确认两个商品都被正确包含：

// 如果是手动构建的数组参数
print_r($order);

// 如果是SDK对象，转成数组查看
print_r($previewRequest->toArray());

正常情况下，你应该能看到Items.member是一个包含两个元素的数组，而不是单个对象。

4. 检查SDK版本（可选） #

如果上面的方法都没用，可能是你用的MWS PHP SDK版本太旧，存在多成员数组解析的bug。可以尝试升级到官方最后维护的MWS SDK版本（注意MWS已逐步迁移到SP-API，但如果仍在使用MWS，优先用官方稳定版）。

按照上面的步骤调整后，两个商品应该都能出现在$itemList里，不会再出现覆盖的问题了。

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