CPFriendlyURLEntryImpl error after upgrading to Commerce 2.1.2

Legacy Knowledge Base

Published Jul. 2, 2025

CPFriendlyURLEntryImpl error after upgrading to Commerce 2.1.2

Written By

Rafael Regner

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

After upgrading Liferay Commerce to version 2.1.2, the following error is thrown in the Liferay log:

ERROR [default task-14][BasePersistenceImpl:440] Caught unexpected exception
org.hibernate.MappingException: Unknown entity: com.liferay.commerce.product.model.impl.CPFriendlyURLEntryImpl

Most of our services use friendlyURL information and several fragments of the portal are not displayed due to this error.

Environment

Liferay DXP 7.2
Commerce 2.1.2

Resolution

Commerce has moved from using Commerce Friendly URL to Liferay Friendly URL.
Any custom code that is using CPFriendlyURLEntry will need to be updated to use a different class.
The classes listed will need to be replaced:
- CPFriendlyURLEntry
- CPFriendlyURLEntryLocalService
Replace with the following new classes:
- FriendlyURLEntry
- FriendlyURLEntryLocalService