Fehlermeldung mit Datenbankversion beim Aktualisieren der Datenbank

Beim Update einer Contao-Installation kann es vorkommen, dass beim Aktualisieren der Datenbank eine ähnliche Fehlermeldungen wie die folgenden erscheinen:

Wrong database version configured …

oder

You have version 10.5.22-MariaDB-1:10.5.22+maria~ubu2004-log but the database connection is configured to mariadb-10.2.7.

oder

Wrong database version configured, please set it to 5.5.5-10.11.6-MariaDB-1:10.11.6+mariadeb11-log, currently set to "5.5.5-10.3.28-MariaDB-1:10.3.28

Was ist hierfür die Ursache?

Früher würde automatisch die Datenbankversion in den Konfigurationsdateien parameters.yml oder .env.local von Contao hinterlegt. Wenn sich nun die Version der Datenbank auf dem Server durch ein Update oder Umzug verändert, dann führt das zur besagten Fehlermeldung. Deswegen sollte der Eintrag der Datenbankversion komplett entfernt werden.

Lösung

Je nach Contao-Version befindet sich die Konfiguration der Datenbank in der config/parameters.yml oder die der .env.local.

Konfiguration in .env.local

Hier muss beim Datenbank-String der Zusatz ?serverVersion=XXX entfernt wird. In folgendem Beispiel wäre das ?serverVersion=5.7.9 (also nur der fett gedruckte Bereich)

DATABASE_URL=mysql://root:root@localhost:3306/cto52?serverVersion=5.7.9

Konfiguration in config/parameters.yml

In dem Fall muss die komplette Zeile database_version: xxx entfernt werden.

Cache neu aufbauen

Nach der Änderung muss der Cache einmal neu aufgebaut werden, damit die Anpassungen aktiv werden.
Danach solltest du keine Fehlermeldung mehr erhalten und die Aktualisierung der Datenbank problemlos funktionieren.