“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中创建的用户一致。

立即学习“PHP免费学习笔记（深入）”；

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

相关文章： Win11怎么设置虚拟桌面 Win11新建多桌面切换操作【技巧】  Jasper AI如何做SEO优化 Jasper AI结合SurferSEO用法【教程】  软银完成对 OpenAI 的 225 亿美元追加投资  MAC如何设置网卡MAC地址克隆_MAC终端修改物理地址与环境模拟【教程】  Laravel如何使用Spatie Media Library_Laravel图片上传管理与缩略图生成【步骤】  Mac自带的词典App怎么用_Mac添加和使用多语言词典【技巧】  标题：如何同时实现 Scroll-Snap 与背景色平滑过渡效果  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  html5 plus怎么调用_HTML5 Plus在HBuilder中调用扫码拍照等原生API【调用】  在Java中接口为什么支持多实现_多继承替代方案解析  Python递归函数优化_尾递归与迭代解析【教程】  Windows家庭版如何开启组策略(gpedit.msc)？（安装方法）  洁耳护耳双专家，家里人人都好用——蜂鸟bebird专业耳朵护理仪重磅上市！  如何在Golang中判断接口类型_Golang reflect类型断言与判断方法  如何为不同团队 ID 动态生成多个非值班状态按钮  Python跨平台应用进阶教程_PyInstaller打包与兼容实践  JavaScript如何实现单例模式_怎样确保全局只有一个实例  java调用shell脚本的方法  exel表格有汉字数字怎么加减运算_Excel混合数据加减计算技巧  Java类图为什么重要_OOP UML类图结构讲解  小红书年度报告怎么看 小红书年度总结查看入口指南【教程】  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  php485在linux下权限不够怎么办_php485串口权限配置教程【技巧】  解决 Telegram Web View 在 iOS 中软键盘遮挡输入框的问题  JavaScript如何实现路由_前端路由原理是什么  Word如何制作组织结构图？Word快速生成公司部门架构图【教程】  javascript如何操作浏览器历史记录_怎样实现无刷新导航  如何实现流畅无抖动的 Marquee 滚动动画  DeepSeek写合同怎么用_DeepSeek写合同使用方法详细指南【教程】  html5audio标签播放结束怎么触发事件_onended回调方法【教程】 

相关栏目： 【 行业资讯17850 】 【 软件资源51899 】 【 网站技术89748 】 【 百度推广44206 】 【 网络营销84187 】 【 运营推广93002 】 【 AI优化91086 】 【 网络优化117696 】 【 网址导航107142 】