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  # 数据库 

相关文章： PHP 500报错的快速解决方法  如何快速生成专业多端适配建站电话？  完全自定义免费建站平台：主题模板在线生成一站式服务  网页设计网站制作软件,microsoft office哪个可以创建网页？  桂林网站制作公司有哪些,桂林马拉松怎么报名？  设计网站制作公司有哪些,制作网页教程？  如何通过VPS搭建网站快速盈利？  Android滚轮选择时间控件使用详解  建站主机选择指南：服务器配置与SEO优化实战技巧  北京企业网站设计制作公司,北京铁路集团官方网站？  制作网站建设的公司有哪些,网站建设比较好的公司都有哪些？  电商平台网站制作流程,电商网站如何制作？  如何登录建站主机？访问步骤全解析  如何续费美橙建站之星域名及服务？  建站之星代理如何优化在线客服效率？  如何快速生成高效建站系统源代码？  如何使用Golang table-driven基准测试_多组数据测量函数效率  网站图片在线制作软件,怎么在图片上做链接？  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  存储型VPS适合搭建中小型网站吗？  可靠的网站设计制作软件,做网站设计需要什么样的电脑配置？  建站之星如何修改网站生成路径？  网站制作知乎推荐,想做自己的网站用什么工具比较好？  哈尔滨网站建设策划,哈尔滨电工证查询网站？  百度网页制作网站有哪些,谁能告诉我百度网站是怎么联系？  建站之星在线客服如何快速接入解答？  如何通过远程VPS快速搭建个人网站？  如何在橙子建站中快速调整背景颜色？  C#怎么使用委托和事件 C# delegate与event编程方法  建站之星微信建站一键生成小程序+多端营销系统  网页设计与网站制作内容,怎样注册网站？  用v-html解决Vue.js渲染中html标签不被解析的问题  在线ppt制作网站有哪些,请推荐几个好的课件下载的网站？  股票网站制作软件,网上股票怎么开户？  建站主机选哪种环境更利于SEO优化？  独立制作一个网站多少钱,建立网站需要花多少钱？  TestNG的testng.xml配置文件怎么写  c++怎么编写动态链接库dll_c++ __declspec(dllexport)导出与调用【方法】  正规网站制作公司有哪些,目前国内哪家网页网站制作设计公司比较专业靠谱？口碑好？  装修招标网站设计制作流程,装修招标流程？  教学论文网站制作软件有哪些,写论文用什么软件 ？  如何通过VPS建站实现广告与增值服务盈利？  企业宣传片制作网站有哪些,传媒公司怎么找企业宣传片项目？  建站之星客服服务时间及联系方式如何？  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  公司网站的制作公司,企业网站制作基本流程有哪些？  如何在Ubuntu系统下快速搭建WordPress个人网站？  网站制作壁纸教程视频,电脑壁纸网站？  如何在VPS电脑上快速搭建网站？  mc皮肤壁纸制作器,苹果平板怎么设置自己想要的壁纸我的世界？