文件

Apple Pay網域驗證因Adobe Commerce中的唯讀根目錄而失敗

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

在Managed Services上的Adobe Commerce中，Apple Pay網域驗證失敗，因為根層級.well-known目錄受限制且無法寫入。 若要修正此問題，請將驗證檔案託管在可寫入的目錄中，並使用.magento.app.yaml檔案或Fastly VCL程式碼片段來設定路由。

說明 description

環境

  • 產品： Managed Services上的Adobe Commerce
  • 版本： 2.4.x
  • 受影響的環境：生產、預備

問題/症狀

  • 無法驗證Apple Pay網域，因為無法寫入根目錄。
  • 根目錄是唯讀的。
  • 根據Apple的需求，不允許重新導向301。

解決方法 resolution

若要成功放置所需檔案並設定它以進行Apple Pay網域驗證，請按照以下步驟操作：

  1. 在.well-known下建立/pub/media/目錄。
  2. 從Apple Pay下載apple-developer-merchantid-domain-association.txt檔案。
  3. 將檔案上傳至/pub/media/.well-known/。

然後，使用下列其中一種方法來設定路由：

方法1：使用.magento.app.yaml

  • 將下列設定新增至您的.magento.app.yaml檔案：

    code language-none 
    "/.well-known":
  root: "pub/media/.well-known"
  allow: true
  scripts: false
  expires: 1y

  • 將變更推送至您的環境。

方法2：使用Fastly VCL程式碼片段

  • 登入Magento Admin並移至： 商店 > 組態 > 進階 > 系統

  • 展開 完整頁面快取，然後移至 Fastly設定 >   自訂VCL程式碼片段。

  • 按一下 建立，然後新增下列規則：

    code language-none 
    if (req.url.path == "/.well-known/apple-app-site-association") {
  set req.url = "/media/.well-known/apple-app-site-association";
}

  • 使用易記名稱，例如Apple_domain_association。

  • 將型別設定為recv並將優先順序設定為100。

  • 按一下[建立]，然後按一下[上傳Fastly VCL]以套用變更。

您現在應該可以在以下位置存取檔案：
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

相關閱讀

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f