Error: Unable to resolve XML entity

Applies to: 

• Liquibase Pro
• Liquibase Open Source (Community)

Conditions:

• Liquibase Pro or Liquibase Community
• Using an XML changelog

Issue Summary:

When running any Liquibase command, an error stating that the XML identity cannot be resolved. 

Error Message:

Error message example from v4.21.1

Unexpected error running Liquibase: Unable to resolve xml entity http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.21.1.xsd. liquibase.secureParsing is set to 'true' which does not allow remote lookups. Check for spelling or capitalization errors and missing extensions such as liquibase-commercial in your XSD definition. Or, set it to 'false' to allow remote lookups of xsd files.

Root Cause:

In the header for an XML changelog, Liquibase has published XSD files that define Liquibase elements and structures that can be used inside the XML changelog.

If any of the URLs in the XML header cannot be resolved, Liquibase will display the error that it cannot resolve the specified URL in the error message.

Example

• Invalid URL: http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.21.1.xsd
• Valid URL: http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.21.xsd

Resolution:

Check the URL from the error message that is causing the error and change it to an accepted value.

You can view all available XSD files at Liquibase XML Schema Definitions.

Related Article(s):

N/A