MySQL Docker PDO连接1045_配置文件检查_PDO连接配置修复
网站迁移、服务器更换、MySQL升级后，经常出现SQLSTATE[HY000] [1045] (using password: YES)错误，因为数据库连接信息发生了变化但程序配置没有同步更新。这个错误会导致网站无法连接数据库，显示数据库连接错误或白屏。快速定位和解决这个错误是网站运维的基本技能。本文从错误原理、排查步骤、常见原因、解决方案四个方面详细讲解。
原因三：host不匹配。MySQL用户的host字段指定了允许连接的来源，如果配置文件中连接主机是localhost，但MySQL中只有'user'@'%'没有'user'@'localhost'，可能导致认证失败（特别是存在匿名用户时）。检查用户的host字段，根据连接方式创建对应用户。从本地连接使用localhost或127.0.0.1，从远程连接使用客户端IP或%（允许所有IP）。PHP配置文件中，如果数据库主机是localhost，MySQL使用socket连接，匹配'user'@'localhost'；如果是127.0.0.1，使用TCP连接，匹配'user'@'127.0.0.1'或'user'@'%'。确保用户的host与连接方式匹配。
原因五：密码含特殊字符或编码问题。密码中包含特殊字符（如$、!、#、&、空格、中文），在配置文件中可能被解析为其他含义，导致传递的密码不正确。PHP配置文件中，密码字符串用单引号包裹，避免双引号中的变量解析（如$符号）。如果密码中有单引号，需要转义。确认密码没有前后空格，复制粘贴时可能带入空格。尝试在命令行使用相同密码登录：mysql -u 用户名 -p，输入密码，如果命令行可以登录但PHP不行，说明是配置文件解析问题。修改密码为不含特殊字符的强密码测试。
PDO连接MySQL的正确配置示例。$pdo = new PDO('mysql:host=localhost;dbname=数据库名;charset=utf8mb4', '用户名', '密码', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, PDO::ATTR_EMULATE_PREPARES => false]);。注意事项：host根据实际情况填写localhost或127.0.0.1或远程IP；port如果不是默认3306需要指定；charset设置为utf8mb4（支持完整Unicode）；密码作为第三个参数传递，不要在DSN字符串中；ATTR_EMULATE_PREPARES设为false使用原生预处理，更安全。配置文件中的密码用单引号包裹，避免特殊字符解析问题。
真实经历：网站突然数据库连接1045，排查后发现是MySQL中'user'@'localhost'用户被误删了，只剩下'user'@'%'，而程序配置的主机是localhost。创建了'user'@'localhost'用户后恢复。MySQL的用户是用户名+主机名组合，这个细节很容易忽略，删除用户时一定要谨慎。
安全提示：生产环境不要用root用户连接网站程序，创建独立用户并授予最小权限。数据库用户host限制为localhost或特定IP，不要开放远程连接。配置文件权限600，防止其他用户读取数据库密码。使用强密码并定期更换，修改密码后同步更新所有配置文件。
更新时间：2026-09-01 12:55:45