在大寫副檔名的PNG檔案中,AEM Assets傳回404錯誤

Adobe Experience Manager (AEM) Assets透過Dispatcher存取時,可能會針對具有大寫副檔名的已發佈PNG資產傳回​404 Not Found,因為其篩選規則會將副檔名視為區分大小寫,而且可能僅允許小寫副檔名。 雖然資產在DAM中仍可使用,但篩選器會封鎖具有大寫副檔名的請求。 若要解決此問題,請使用小寫副檔名標準化資產檔案名稱,或更新Dispatcher篩選規則以允許小寫和大寫PNG副檔名。

說明 description

環境

Adobe Experience Manager (AEM) Assets (使用Dispatcher的所有版本和部署模型)

問題/症狀

將具有小寫和大寫PNG副檔名的資產(例如asset1.png和asset1.PNG)上傳到AEM Assets並在AEM Screens管道或其他元件中參考時,會發生下列症狀:

  • 在Author環境中,.png和.PNG資產皆可存取,並傳回​HTTP 200 OK。
  • 在透過Dispatcher存取的發佈環境中,.png資產的請求會傳回​HTTP 200 OK。
  • .PNG資產的請求傳回​HTTP 404 Not Found,即使資產已發佈並可在DAM中使用。

根本原因

Dispatcher篩選器會將副檔名視為區分大小寫。 依預設,其篩選規則可能僅允許小寫副檔名,例如.png。 除非篩選規則明確允許,否則會封鎖對大寫副檔名(例如.PNG)的資產要求,而導致​ 找不到HTTP 404 ​錯誤。

解決方法 resolution

若要解決問題,請使用下列其中一種方法:

標準化資產檔案副檔名(建議)

  1. 請確定所有上傳的資產檔案名稱都使用小寫副檔名,例如.png而非.PNG。
  2. 將此命名慣例傳達給內容作者和相關團隊,以避免問題重複發生。

更新Dispatcher篩選規則

  1. 找到Dispatcher設定目錄,然後開啟篩選規則設定檔案。
  2. 新增或更新規則,以允許相關DAM路徑的.png和.PNG副檔名。
  3. 將變更儲存至組態檔。
  4. 在測試環境中測試設定,並確認可存取.png和.PNG資產。
  5. 將更新的設定部署到即時環境。
  6. 排清快取以確保變更生效。
  7. 確認可透過發佈環境存取同時具有.png和.PNG擴充功能的資產。
recommendation-more-help
experience-cloud-kcs-help-kbarticles