错误源于PHP未传用户名，导致MySQL以空用户''@'localhost'认证失败；常见于phpEnv未启用、.env路径错误、解析失败或变量未定义，需检查$_ENV值、phpEnv扩展及配置语法。
这个错误不是密码错了，而是 PHP 没传用户名，MySQL 用空字符串当用户名去认证，自然匹配到 ''@'localhost' 这个不存在或无权的匿名用户。phpEnv 环境下尤其容易因配置文件未加载、变量未定义或 .env 解析失败导致 $username 为空。
为什么会出现 Access denied for user ''@'localhost'
MySQL 认证时，如果 PHP 连接代码里 mysqli_connect() 的第一个参数（用户名）是空值（null 或空字符串），MySQL 就会尝试用 ''@'localhost' 登录——这不是你漏填密码，是根本没传用户名。
- 常见于使用
$_ENV或getenv()读取 .env 变量，但phpEnv没启用或.env文件路径不对，导致DB_USER读出来是空 -
parse_ini_file()读取配置失败（比如权限不足、路径写错、BOM 头导致解析中断），返回数组中user键值为空 - 框架如 Laravel 在
config/database.php中引用env('DB_USERNAME')，但phpEnv未正确加载，env()返回默认值null，而你又没设 fallback - 注意：MySQL 默认安装后可能有
''@'localhost'匿名用户，但它通常没密码也没权限，不建议启用或依赖它
检查 phpEnv 是否真正生效
别只看 .env 文件存在，要确认变量真被 PHP 读进来了。
- 在连接数据库前加一句
var_dump($_ENV['DB_USERNAME'] ?? 'NOT_SET');，输出是string(0) ""就坐实是空值问题 - 确认
phpEnv扩展已启用：php -m | grep phpenv（命令行）；或phpinfo()页面搜索phpenv - 检查
.env文件是否在 PHP 工作目录下（getcwd()输出路径），不是在项目根目录却在子目录运行脚本 - 确保
.env里没有语法错误：等号前后不能有空格，不能用单引号包住值（DB_USER='root'是错的，应写DB_USER=root），中文字符或 BOM 头会导致整行失效
mysqli_connect() 调用时用户名为空的硬性防御
即使配置层出问题，连接函数本身也该有兜底逻辑，避免把空字符串直接扔给 MySQL。
Accessibility Review
下载
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
立即学习“PHP免费学习笔记（深入）”；
- 显式判断并报错：
$user = $_ENV['DB_USERNAME'] ?? ''; if (!$user) { throw new RuntimeException('DB_USERNAME is empty, check .env or phpenv config'); } - 用
mysqli_connect()前强制转换：$user = (string) ($_ENV['DB_USERNAME'] ?? '');，但注意空字符串仍会触发''@'localhost' - 更稳妥的是设默认值：
$user = $_ENV['DB_USERNAME'] ?? 'root';，前提是你知道默认用户存在且有权限 - 不要依赖
mysqli_connect('localhost', '', 'pass')—— 第二个参数为空就等于没传用户名，MySQL 会按空用户处理
phpEnv + XAMPP / WAMP 场景下的典型陷阱
本地开发环境常踩的坑，和服务器部署逻辑不同。
- XAMPP 自带的 MySQL 默认 root 密码为空，但 phpEnv 如果从 .env 读不到
DB_PASSWORD，就会传空字符串过去，结果变成root用户用空密码登录——而 MySQL 5.7+ 默认要求密码，报错却显示''@'localhost'（因为用户名字段先崩了） - WAMP 的 php.ini 可能禁用了
putenv()，导致phpEnv无法注入环境变量，$_ENV始终为空 - Apache 的
httpd.conf或.htaccess里没开AllowOverride All，导致SetEnv指令不生效 - Docker + phpEnv：容器内 PHP 读不到宿主机的 .env，必须通过
volumes挂载或environment字段显式传入
最常被忽略的一点：错误信息里的 ''@'localhost' 中的空用户名，99% 源自 PHP 层变量未定义或读取失败，而不是 MySQL 侧配置问题。盯住 $_ENV 或配置数组的原始值，比反复重置 MySQL 密码有效得多。
