每个数据库用户权限必须独立授权，即每个connections键对应一套独立MySQL凭证，需为每个库单独创建用户并显式授权；须检查用户是否存在、host精确匹配、认证插件兼容（如改用mysql_native_password）、.env变量大小写一致且手动拼接正确。
确认每个数据库用户权限是否独立授权
ThinkPHP5 多库连接不是“共用一个账号”，而是每个 connections 键对应一套独立凭证，必须为每个库单独创建 MySQL 用户并显式授权。常见错误是只给主库用户授了权，却让第二个库也复用同一账号——而该账号在第二库的 mysql.user 表里根本不存在。
操作步骤：
- 进 MySQL 执行
SELECT User, Host FROM mysql.user WHERE User = 'db2_user';，确认该用户是否存在于目标库所在 MySQL 实例中 - 若查不到，需登录该 MySQL 服务器（非 ThinkPHP 所在机器），执行：
CREATE USER 'db2_user'@'127.0.0.1' IDENTIFIED BY 'strong_pass'; - 再执行：
GRANT SELECT, INSERT ON `log_db`.* TO 'db2_user'@'127.0.0.1'; FLUSH PRIVILEGES;（注意反引号包裹数据库名） - 别用
GRANT ALL ON *.*，最小权限原则；log_db必须存在且拼写一致
检查 host 匹配是否精确（localhost ≠ 127.0.0.1）
报错里出现 'db2_user'@'localhost' 但你实际用的是 'host' => '127.0.0.1'，或反过来，都会导致权限拒绝。MySQL 把这两个 host 视为完全不同的用户记录。
验证方法：
立即学习“PHP免费学习笔记（深入）”；
- 在 ThinkPHP 控制器里加
dump(env('DB2_HOST'));，确认运行时真正读到的 host 值 - 执行
SELECT Host FROM mysql.user WHERE User = 'db2_user';，看返回的 Host 字段值是localhost、127.0.0.1还是% - 如果配置是
'host' => 'localhost'，MySQL 必须有'db2_user'@'localhost'记录；如果是'host' => '127.0.0.1'，就必须匹配'db2_user'@'127.0.0.1' - Docker 场景下，
DB2_HOST不能填localhost（它指向容器自己），得填容器名如mysql-log，对应权限记录也得是'db2_user'@'mysql-log'
排查 .env 变量是否被正确加载到第二个连接
.env 文件不支持嵌套语法，像 DB2_USERNAME 这种变量名可以，但 database.connections.log_db.username 这类写法无效。多库配置必须靠手动拼接，稍有遗漏就会让第二个连接的 username 或 password 变成 null，最终触发权限不足。
典型错误配置：
-
.env写了db2_password=abc123，但database.php里写成env('DB2_PASSWORD')（大小写不一致，读不到） -
database.php中connections['log_db']没写全字段，漏了'type' => 'mysql'，框架会 fallback 到默认驱动，报错看似权限问题，实则是驱动未识别 - 没在
connections['log_db']中显式声明'hostname'和'username'，而是依赖全局database配置，导致第二个库误用了主库的账号
MySQL 8+ 用户认证插件不兼容会伪装成权限错误
当错误信息里出现 caching_sha2_password 或报错提示 “Access denied” 但密码确认无误时，大概率是 MySQL 8.0+ 默认认证方式与 PHP 的 pdo_mysql 扩展不兼容。它不会报“认证方式不支持”，而是直接返回权限拒绝。
快速验证和修复：
- 进 MySQL 查当前用户插件：
SELECT user, host, plugin FROM mysql.user WHERE user = 'db2_user'; - 如果是
caching_sha2_password，执行：ALTER USER 'db2_user'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'strong_pass'; FLUSH PRIVILEGES; - 确保 PHP 版本 ≥ 7.4，且
phpinfo()显示已启用pdo_mysql扩展 - ThinkPHP 配置中强制走 TCP：把
'hostname'固定设为'127.0.0.1'，避免因localhost触发 socket 连接，加剧认证插件冲突
多库权限问题最常卡在“以为配对了，其实 host 或插件不匹配”，而不是账号密码本身。每次改完权限，务必用 mysql -u db2_user -h 127.0.0.1 -p log_db 在命令行交叉验证，绕过 ThinkPHP 直接看 MySQL 是否真放行。
