AEM Cloud Manager部署因使用者端程式庫資源中的HTL編譯錯誤而失敗

✨ 此內容是AI產生的,可能不準確。 產生AI辭彙

本文說明當使用者端程式庫Cloud Manager資源中的JavaScript範本常值被AEM剖析器錯誤解譯時,如何解決HTL編譯錯誤所導致HTML部署失敗。

說明 description

環境

  • Adobe Experience Manager (AEM) Cloud Manager (所有版本)

症狀

Cloud Manager建置會在所有環境(開發、預備和生產)的部署步驟中失敗。 管道記錄在使用者端程式庫資源檔案中顯示HTL編譯錯誤。 剖析器會報告錯誤,例如:

  • mismatched input '(' expecting {'}', '@'}

受影響的資源包括使用者端資料庫中的HTML檔案,這些檔案包含.html檔案中的JavaScript範本常值運算式(例如${getAccessToken()})。 這些會解譯為HTL運算式,導致部署期間發生剖析器錯誤。

原因

部署失敗,因為.html使用者端程式庫資源中的JavaScript範本常值運算式(${...})會由AEM剖析器解譯為HTL運算式,導致在HTL編譯步驟期間出現語法錯誤。

解決方法 resolution

請依照下列步驟解決問題。

  1. 檢閱程式碼基底中受影響的使用者端程式庫資源檔案(例如/apps/.../clientlibs/.../resources/內的HTML檔案)。
  2. 在這些.html檔案中使用${...}語法檢查JavaScript範本常值運算式。
  3. 如果這些運算式用作JavaScript,請確保AEM剖析器不會將其解譯為HTL運算式。
  4. 將包含範本常值之JavaScript程式碼移至.js個檔案,而非直接內嵌至.html資源。 或者,逸出或重構${...}語法以避免HTL剖析衝突。
  5. 重新執行Cloud Manager管道,確認HTL編譯錯誤已解決。
recommendation-more-help
experience-cloud-kcs-help-kbarticles