[Error] Something unusual has occurred to cause the driver to fail

Applies to: 

• Liquibase Pro
• Liquibase Open Source (Community)

Conditions:

• Liquibase Pro and Open Source versions prior to v4.8.0

Issue Summary:

When trying to perform any Liquibase command that attempts to connect to the database, the below error message occurs, and an established connection cannot be made.

Error Message:

Unexpected error running Liquibase: Connection could not be created to  with driver .  Something unusual has occurred to cause the driver to fail. Please report this exception.

Root Cause:

The root cause is that the password is not being properly applied to the connection. From Liquibase v4.8.0 onward, this error message has been improved to include what is missing.

The newer version of the error message when the password isn't supplied is:

Unexpected error running Liquibase: Connection could not be created to  with driver .  The server requested SCRAM-based authentication, but no password was provided.

Resolution:

Ensure that the password is set using one of the accepted parameters, which are listed below, that Liquibase reads the password from.

• CLI Argument

  • --password

• Liquibase Flow File

  • cmdArgs: {password: "val"} 

• Liquibase Properties file

  • liquibase.command.password 

• Liquibase Environment variable

  • LIQUIBASE_COMMAND_PASSWORD

Related Article(s):

Database Connections