文件Commerce工具

ACP2E-4156： REST API送貨地址驗證會忽略管理員屬性設定

最後更新： 2026年6月23日

建立對象：

  • Experienced
  • Admin
  • Developer

ACP2E-4156修補程式修正REST API中的送貨地址驗證不符合Admin中定義的屬性組態的問題。 安裝Quality Patches Tool (QPT) 1.1.80時，即可使用此修補程式。 修補程式ID為ACP2E-4156。 請注意，此問題已排程在Adobe Commerce 2.4.9中修正。

受影響的產品和版本

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

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

與Adobe Commerce版本相容：

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

問題

在REST API中，送貨地址驗證不會遵循在Admin中設定的客戶地址屬性設定。

要再現的步驟：

  1. 前往管理面板中的​Stores > Attributes > Customer Address。

  2. 開啟屬性代碼為​ firstname ​的屬性。

  3. 在​ Attribute Properties ​底下，設定：

    1. Input Validation：僅限長度。
    2. Minimum Text Length: 1.
    3. Maximum Text Length: 20.

  4. 前往店面，將測試產品加入購物車。

  5. 傳送REST API要求給/rest/default/V1/guest-carts/cartId/shipping-information，以新增或更新含有​ firstname ​值（長度超過20個字元）的送貨資訊。

預期結果：

傳回錯誤，指出​ firstname ​值超過設定的長度限制。

實際結果：

購物車送貨資訊已成功更新為REST API要求中傳送的​ firstname ​值。

套用修補程式

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

相關閱讀

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

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