ThinkPHP5.1.41数据库连接失败的核心原因是环境与配置不匹配，需按顺序排查：先验证MySQL服务连通性（用127.0.0.1而非localhost），再核对database.php中hostname、port、用户名密码（特殊字符需URL编码）、charset（推荐utf8mb4），MySQL 8.0+用户须将认证插件改为mysql_native_password，并确认pdo/pdo_mysql扩展已启用且错误提示开启。
ThinkPHP5.1.41安装后数据库连接失败，核心问题通常不在框架本身，而是环境与配置的匹配性没对上。直接看报错里的 PDOException message 最有效——它会明确告诉你“Connection refused”“Access denied”还是“No such file or directory”，每种对应不同层级的问题。
先手动验证 MySQL 是否真能连通
别急着改 config/database.php，先在命令行跑这一句：
- mysql -h 127.0.0.1 -P 3306 -u root -p（注意用 127.0.0.1，不是 localhost）
- 如果这步就输密码后报错，说明 MySQL 服务没起来、端口被占、或账号权限不对——ThinkPHP 肯定也连不上
- 若能进 MySQL，再执行 SELECT User, Host FROM mysql.user;，确认你用的用户（比如 root）的 Host 是 % 或 127.0.0.1，而不是仅 localhost（二者在 MySQL 里算不同主机）
检查 database.php 配置是否和实际一致
打开 config/database.php，重点核对这几项：
- hostname：本地开发建议写 127.0.0.1；Docker 环境必须写容器名（如 mysql）或 host.docker.internal
- hostport：留空默认是 3306，但如果你改过 MySQL 的 my.cnf，这里必须同步填对
- username / password：密码含特殊字符（如 @ / :）时，需 URL 编码后再填入，否则 PDO 解析会出错
- charset：推荐设为 utf8mb4，并确保 MySQL 侧也支持（检查 collation_server 和 character_set_server）
MySQL 8.0+ 用户特别注意认证插件
ThinkPHP5.1.41 默认用 PDO 连接，而 MySQL 8.0 默认用 caching_sha2_password 插件，PHP 7.4 及更早版本不兼容——表现就是静默失败或报 “Authentication plugin cannot be loaded”。
立即学习“PHP免费学习笔记（深入）”；
- 登录 MySQL 后执行：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
- 执行 FLUSH PRIVILEGES; 生效
- Navicat 用户可在“用户”管理界面里，把插件下拉框手动改成 mysql_native_password，记得重新输入密码
确认 PHP 扩展和错误提示已打开
TP5.1 不依赖 .env，但需要基础扩展支持：
- 运行 php -m | grep pdo，确认 pdo 和 pdo_mysql 都在列表中
- 临时在入口文件（如 public/index.php）顶部加三行，强制显示错误：
ini_set('display_errors', 1);
error_reporting(E_ALL);
ini_set('display_startup_errors', 1); - 这样 PDO 异常信息就能直接打出来，不用靠猜
