This article explains why MySQL database passwords may stop working after a server upgrade and how to resolve the issue using cPanel.
Scope and affected environments
This issue occurs on servers upgraded to MySQL version 5.6.5 or later. It affects applications that rely on existing MySQL users created before the upgrade. Typical environments include shared and reseller hosting accounts running applications such as WordPress.
Identifying the MySQL version
Vor fortfahren, confirm the MySQL version installed on the server.
- Melden Sie sich bei CPanel an.
- On the main page, locate the GENERAL INFORMATION Abschnitt.
- Klicken Server Information.
- Check the value shown for MySQL Version.
[Screenshot placeholder: cPanel Server Information panel]
Problem description
Database connections fail even though the correct database username and password are configured. Applications commonly display database connection errors indicating authentication failure.
Root cause
MySQL 5.6.5 and later versions use a newer password hashing mechanism. User accounts created on older MySQL versions may still use a legacy hash format that is no longer supported. Infolge, authentication fails even with valid credentials.
Resolution overview
The solution is to recreate the affected database user so MySQL stores the password using the current hashing method. The database itself does not need to be recreated.
Recreating the database user
- Melden Sie sich bei CPanel an.
- Öffnen Sie die Tools page.
- Im Datenbanken Abschnitt, klicken Manage My Databases.
- Unter Current Users, locate the affected database user.
- Klicken Löschen and confirm the removal.
- Scroll to Add New User.
- Enter the same username that was deleted.
- Enter the database password.
- Confirm the password and click Create User.
[Screenshot placeholder: MySQL user deletion and recreation]
The password does not need to be changed. Existing application configuration files can continue using the same credentials.
Reassigning user privileges
After recreating the user, ensure it is assigned to the correct database.
- In Manage My Databases, locate Add User to Database.
- Select the recreated user and the target database.
- Klicken Hinzufügen.
- Assign the required privileges or select ALL PRIVILEGES.
- Save the changes.
[Screenshot placeholder: Assigning MySQL user privileges]
Application verification
Once the user is recreated and permissions are restored, reload the affected website or application. Database connectivity should be restored immediately.
Operational considerations
Database compatibility issues are more common during platform upgrades. Environments with frequent version changes or custom database requirements may benefit from infrastructure such as cloud servers or a dedicated server, which provide greater control over database versions and upgrade timing. Applications running on cPanel hosting should always be tested after major database upgrades.