# MySQL 8.4 mysql_native_password disabled by default authentication plugin error official documentation

Status: search-observed
Product: MySQL 8.4
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/mysql-8-4-mysql-native-password-disabled-by-default-authentication-plugin-error-official-documen
Machine JSON: https://gitdocs.org/api/fixes/mysql-8-4-mysql-native-password-disabled-by-default-authentication-plugin-error-official-documen.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

Client credentials and code are unchanged; the database server's current plugin/default configuration determines whether authentication succeeds.

## Fix

```
Verifier checks a supported authentication path without globally weakening the server. Check operational state and security, not a compatibility switch that weakens the server.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- MySQL 8.4 mysql_native_password disabled by default authentication plugin error official documentation
- site:dev.mysql.com/doc MySQL 8.4 mysql_native_password disabled by default
- https://dev.mysql.com/doc/refman/8.4/en/native-pluggable-authentication.html

## Sources

- MySQL 8.4.0 release notes: https://dev.mysql.com/doc/relnotes/mysql/8.4/en/news-8-4-0.html
- Official reference opened by Codex: https://dev.mysql.com/doc/refman/8.4/en/native-pluggable-authentication.html