DuplicateFileEntryException on Virtual Instance Startup

Legacy Knowledge Base

Published Jun. 30, 2025

DuplicateFileEntryException on Virtual Instance Startup

Written By

Emma Carr-Gardner

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

A `DuplicateFileEntryException` error occurs when starting a clustered DXP instance after a virtual instance is created, even if the file already exists in the Document Library. The error, seen in the logs, resembles the following:

INFO  [ajp-nio-0.0.0.0-8009-exec-13][BundleSiteInitializer:443] Initializing com.liferay.site.initializer.welcome for group <groupId>
ERROR [ajp-nio-0.0.0.0-8009-exec-13][BundleSiteInitializer:634] null
com.liferay.document.library.kernel.exception.DuplicateFileEntryException: A file entry already exists with title astronaut.png

Clearing the temp and state folders does not resolve the error.

Environment

Liferay DXP 7.4 Quarterly Releases

Resolution

The root cause is the site initializer attempting to run on virtual instances with no public pages. Creating a public page for each virtual instance will resolve the issue.