php本地部署后数据库连接报错_1045accessdenied错误解决方法详解【汇总】

发布日期： 2026-01-01 阅读量： 作者： 雪夜

“1045 Access denied”错误源于MySQL认证失败，需依次检查：一、配置文件用户名密码是否匹配；二、用户Host权限是否与PHP连接地址一致（localhost/127.0.0.1/%）；三、MySQL 8.0+插件兼容性（caching_sha2_password需改为mysql_native_password）；四、bind-address配置是否限制本地连接；五、PHP MySQL扩展是否启用且版本兼容；六、root用户状态及密码是否正确。

如果您在本地部署PHP项目后遇到数据库连接报错“1045 Access denied”，则说明MySQL服务器拒绝了当前提供的用户名或密码认证请求。以下是解决此问题的步骤：

一、检查MySQL用户名和密码是否正确

该错误最常见原因是配置文件中填写的数据库用户名或密码与MySQL实际账户不一致。PHP应用通常通过config.php、.env或database.php等文件读取数据库凭证，需确保其与MySQL中创建的用户完全匹配。

1、打开PHP项目中的数据库配置文件（如.env或config/database.php）。

2、核对DB_USERNAME和DB_PASSWORD字段值是否与MySQL中创建的用户一致。

3、登录MySQL命令行：执行mysql -u root -p，输入root密码后进入MySQL环境。

4、运行SELECT User,Host FROM mysql.user;查看所有用户及其允许访问的主机。

5、确认所用用户名在列表中，且对应Host字段为localhost、127.0.0.1或%。

二、确认用户权限是否授予本地访问权限

MySQL用户可能仅被授权从特定主机连接，若配置中使用127.0.0.1而用户只允许localhost登录，或反之，均会导致1045错误。二者在MySQL中被视为不同主机。

1、在MySQL命令行中执行SELECT Host,User FROM mysql.user WHERE User='your_username';，替换your_username为实际用户名。

2、若返回结果中Host为localhost，但PHP配置中使用127.0.0.1作为数据库主机，则需统一为localhost或修改用户权限。

3、执行CREATE USER 'testuser'@'localhost' IDENTIFIED BY 'password123';创建仅限本地socket连接的用户。

4、执行CREATE USER 'testuser'@'127.0.0.1' IDENTIFIED BY 'password123';创建仅限TCP/IP连接的用户。

5、对新用户执行GRANT ALL PRIVILEGES ON *.* TO 'testuser'@'localhost';并运行FLUSH PRIVILEGES;生效。

三、检查MySQL服务是否启用身份验证插件兼容性

MySQL 8.0+默认使用caching_sha2_password插件，而旧版PHP MySQL扩展（如mysqlnd 7.x及更早）可能不支持该插件，导致认证失败并返回1045错误。

1、登录MySQL后执行SELECT user,host,plugin FROM mysql.user;查看目标用户的认证插件类型。

2、若目标用户plugin列为caching_sha2_password，需切换为mysql_native_password。

3、执行ALTER USER 'your_username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';

4、执行FLUSH PRIVILEGES;

5、重启MySQL服务使变更彻底生效（部分系统需此操作）。

四、验证PHP连接使用的主机地址是否匹配授权范围

PHP代码中数据库主机（host）参数必须与MySQL用户表中Host字段精确匹配。常见不匹配情形包括：配置为localhost但用户仅授权127.0.0.1，或配置为127.0.0.1但用户仅授权localhost；此外，使用%通配符时需确认未被防火墙或bind-address限制。

1、检查PHP数据库连接代码中的$host变量值，例如$host = 'localhost';或$host = '127.0.0.1';。

2、在MySQL中运行SELECT Host,User FROM mysql.user WHERE User='your_username';确认是否存在对应Host记录。

3、若无匹配项，添加授权：执行CREATE USER 'your_username'@'127.0.0.1' IDENTIFIED BY 'your_password';

4、执行GRANT ALL ON your_database.* TO 'your_username'@'127.0.0.1';

5、执行FLUSH PRIVILEGES;

五、排查MySQL配置文件中bind-address限制

MySQL服务器若在my.cnf或my.ini中设置了bind-address = 127.0.0.1或bind-address = ::1，可能影响本地socket连接行为；某些情况下，localhost会尝试走Unix socket，而127.0.0.1强制走TCP，若配置与用户授权不协同，将触发1045。

1、定位MySQL配置文件路径，Linux常见为/etc/mysql/my.cnf或/etc/my.cnf，Windows为my.ini。

2、查找bind-address行，确认其值是否为127.0.0.1、localhost或0.0.0.0。

3、若为127.0.0.1，且PHP中使用localhost连接，可临时改为0.0.0.0测试（仅限开发环境）。

4、修改后保存文件，执行sudo systemctl restart mysql（Linux）或重启MySQL服务（Windows）。

5、再次测试PHP数据库连接，观察错误是否消失。

六、验证PHP MySQL扩展是否启用且版本兼容

PHP若未启用mysqli或PDO_MySQL扩展，或扩展版本过低无法解析新版MySQL认证协议，也可能表现为连接时抛出1045错误（实际为底层认证失败被统一映射）。

1、创建一个phpinfo.php文件，内容为，通过浏览器访问该页面。

2、搜索mysqli或PDO，确认对应扩展已启用并显示版本号。

3、若未启用，在php.ini中取消注释extension=mysqli和extension=pdo_mysql行。

4、确认PHP版本与MySQL版本兼容：PHP 7.4+支持MySQL 8.0的caching_sha2_password，但需mysqlnd 8.0+驱动。

5、执行php -m | grep mysqli（Linux/macOS）或php -m（Windows）验证模块加载状态。

七、检查MySQL root用户是否被禁用或密码为空

部分本地集成环境（如XAMPP、WAMP、MAMP）默认禁用root用户远程登录，或设置空密码但PHP配置中误填了非空密码，也会触发1045错误。尤其在重装或升级后，root用户权限可能被重置。

1、尝试在终端直接执行mysql -u root（不加-p），看是否能免密登录。

2、若失败，尝试mysql -u root -p并输入常见空密码或默认密码root。

3、若仍失败，需以安全模式启动MySQL跳过权限验证：sudo mysqld_safe --skip-grant-tables &

4、另开终端执行mysql -u root进入，然后运行UPDATE mysql.user SET authentication_string=PASSWORD('newpass') WHERE User='root';

5、执行FLUSH PRIVILEGES;并重启MySQL服务。

上一篇: Win10如何卸载预装Edge扩展_Win10卸载Edge扩

下一篇: Windows10如何删除恢复分区_Win10 Diskpa

php本地部署后数据库连接报错_1045accessdenied错误解决方法详解【汇总】

随便看看

南昌壹佳企网络通信有限公司