文件Commerce工具

ACP2E-4628：當「帳戶共用」設定為「全域」時，匯入具有大寫電子郵件地址的客戶會觸發未定義的陣列金鑰錯誤

最後更新： 2026年5月11日

建立對象：

  • Experienced
  • Admin
  • Developer

ACP2E-4628修補程式修正匯入具有大寫電子郵件地址的客戶時，帳戶共用​設定為​ 全域 ​時，導致未定義陣列金鑰錯誤的問題，進而導致匯入失敗。 安裝Quality Patches Tool (QPT) 1.1.78時，即可使用此修補程式。 修補程式ID為ACP2E-4628。 請注意，此問題已排程在Adobe Commerce 2.4.9中修正。

受影響的產品和版本

已為Adobe Commerce版本建立修補程式：

  • Adobe Commerce （所有部署方法） 2.4.8-p1

與Adobe Commerce版本相容：

  • Adobe Commerce （所有部署方法） 2.4.8 - 2.4.8-p4
NOTE
此修補程式可能適用於發行版本為Quality Patches Tool的其他版本。 若要檢查修補程式是否與您的Adobe Commerce版本相容，請將magento/quality-patches套件更新至最新版本，並在Quality Patches Tool上檢查相容性：搜尋修補程式頁面。 使用修補程式ID作為搜尋關鍵字，以尋找修補程式。

問題

使用大寫電子郵件地址並啟用「全域帳戶共用」時，客戶匯入會因未定義的陣列金鑰錯誤而失敗。

要再現的步驟：

  1. 移至「Stores > 設定 > 組態 > Customers > Customer Configuration > Account Sharing Options」。

    1. 將​ Share Customer Accounts ​設定為​全域。

  2. 前往「System > Export > Customer Main File」並匯出現有客戶。

  3. 前往​System > Import > Customer Main File。

    1. 設定Import Behavior以新增/更新複雜資料。
    2. 上傳匯出的檔案，不做任何變更。

  4. 按一下​ Check Data ​按鈕。

預期結果：

即使電子郵件地址包含大寫字元且「帳戶共用」設定為「全域」，客戶匯入仍應順利完成，且不會出現任何錯誤。

實際結果：

匯入失敗，並出現下列錯誤：

Warning: Undefined array key "Uppercase.Email@example.com" in app/code/Magento/CustomerImportExport/Model/ResourceModel/Import/Customer/Storage.php on line 117

套用修補程式

若要套用個別修補程式，請根據您的部署方法使用下列連結：

相關閱讀

若要進一步瞭解Quality Patches Tool，請參閱：

recommendation-more-help
commerce-operations-help-tools