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

“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服务。

# mysql  # php  # linux  # word  # windows  # 防火墙  # 浏览器  # access  # mac  # unix  # macos  # select  # mysqli  # pdo  # database  # 数据库 

相关文章： 公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站？  中山网站制作网页,中山新生登记系统登记流程？  如何在沈阳梯子盘古建站优化SEO排名与功能模块？  焦点电影公司作品,电影焦点结局是什么？  北京制作网站的公司排名,北京三快科技有限公司是做什么？北京三快科技？  详解jQuery中基本的动画方法  如何高效生成建站之星成品网站源码？  建站之星安装路径如何正确选择及配置？  简单实现Android文件上传  如何快速搭建支持数据库操作的智能建站平台？  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  网站制作大概多少钱一个,做一个平台网站大概多少钱？  网站视频怎么制作,哪个网站可以免费收看好莱坞经典大片？  c++如何打印函数堆栈信息_c++ backtrace函数与符号名解析【方法】  seo网站制作优化,网站SEO优化步骤有哪些？  高防网站服务器：DDoS防御与BGP线路的AI智能防护方案  广东专业制作网站有哪些,广东省能源集团有限公司官网？  如何通过VPS建站实现广告与增值服务盈利？  高端建站三要素：定制模板、企业官网与响应式设计优化  清除minerd进程的简单方法  如何在万网自助建站中设置域名及备案？  建站之家VIP精选网站模板与SEO优化教程整合指南  招贴海报怎么做,什么是海报招贴？  制作网站的基本流程,设计网站的软件是什么？  企业在线网站设计制作流程,想建设一个属于自己的企业网站，该如何去做？  网站制作价目表怎么做,珍爱网婚介费用多少？  定制建站平台哪家好？企业官网搭建与快速建站方案推荐  魔方云NAT建站如何实现端口转发？  建站VPS能否同时实现高效与安全翻墙？  如何快速使用云服务器搭建个人网站？  表情包在线制作网站免费,表情包怎么弄？  如何快速生成凡客建站的专业级图册？  长春网站建设制作公司,长春的网络公司怎么样主要是能做网站的？  建站主机解析：虚拟主机配置与服务器选择指南  免费视频制作网站,更新又快又好的免费电影网站？  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  建站之星后台密码遗忘如何找回？  香港服务器建站指南：外贸独立站搭建与跨境电商配置流程  清单制作人网站有哪些,近日“兴风作浪的姑奶奶”引起很多人的关注这是什么事情？  ,如何利用word制作宣传手册？  建站主机选购指南：核心配置优化与品牌推荐方案  红河网站制作公司,红河事业单位身份证如何上传？  教育培训网站制作流程,请问edu教育网站的域名怎么申请？  ,巨量百应是干嘛的？  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样？  常州自助建站费用包含哪些项目？  网站制作知乎推荐,想做自己的网站用什么工具比较好？  视频网站制作教程,怎么样制作优酷网的小视频？  建站之星如何快速解决建站难题？  如何高效利用亚马逊云主机搭建企业网站？