persistence.xml problems

Reports the following problems inside XML configuration files:

References to non-instantiable classes
References to classes that do not extend required class
References to classes with inappropriate scope
Tag and attribute values that do not match required pattern (for example, Java Identifiers)
Tags that do not include required children tags or attributes
Tags that define objects with duplicate names

Example:

<persistence>
    <persistence-unit name="example-persistence-unit">
        <provider>org.example.SomeRandomClass</provider> // Error: provider class should implement PersistenceProvider interface
    </persistence-unit>
</persistence>

Locating this inspection

By ID

Can be used to locate inspection in e.g. Qodana configuration files, where you can quickly enable or disable it, or adjust its settings.

JpaDomInspection

Via Settings dialog

Path to the inspection settings via IntelliJ Platform IDE Settings dialog, when you need to adjust inspection settings directly from your IDE.

Settings or Preferences | Editor | Inspections | JPA

Suppressing Inspection

You can suppress this inspection by placing the following comment marker before the code fragment where you no longer want messages from this inspection to appear:

//noinspection JpaDomInspection

More detailed instructions as well as other ways and options that you have can be found in the product documentation:

IntelliJ IDEA 2025.2

Inspection Details
By default bundled with:	IntelliJ IDEA 2025.2, Qodana for JVM 2025.2,

Last modified: 18 September 2025