# MySQL 8.4 mysql_native_password disabled default authentication plugin caching_sha2_password documentation

Status: search-observed
Product: MySQL 8.4
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/node-mysql2-er-not-supported-auth-mode-with-mysql-8-4
Machine JSON: https://gitdocs.org/api/fixes/node-mysql2-er-not-supported-auth-mode-with-mysql-8-4.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The local workspace gives the symptom and stale integration shape, but the correct repair depends on current official product behavior or recent release notes.

## Fix

```
Verifier accepts a repair record only if it states the current contract and an actionable fix using source-backed product terms.
```

## 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 default authentication plugin caching_sha2_password documentation
- site:dev.mysql.com/doc/refman/8.4 mysql_native_password 8.4 disabled
- https://dev.mysql.com/doc/refman/8.4/en/native-pluggable-authentication.html
- 'caching_sha2_password is the default authentication plugin' in https://dev.mysql.com/doc/refman/8.4/en/caching-sha2-pluggable-authentication.html
- mysql2 caching_sha2_password support GitHub mysql2 documentation
- https://github.com/sidorares/node-mysql2
- https://sidorares.github.io/node-mysql2/docs/documentation/authentication-switch
- 'caching_sha2_password' in https://github.com/sidorares/node-mysql2/blob/master/Changelog.md

## 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
- GitHub source file or repository reference: https://github.com/sidorares/node-mysql2
- Official reference opened by Codex: https://sidorares.github.io/node-mysql2/docs/documentation/authentication-switch