MySQL 5.7降级后Hyperf连不上，主因是认证插件残留（如caching_sha2_password未切回mysql_native_password）、PDO预处理配置未适配、socket路径错误及连接池max_idle_time与MySQL wait_timeout不匹配；需执行ALTER USER重置认证、显式设PDO::ATTR_EMULATE_PREPARES=>true、校准socket路径、调小max_idle_time并启用checker健康检查。
Hyperf 项目里 MySQL 版本降级后连不上、报错或查询异常，基本不是“框架不支持”，而是 mysql_upgrade 没回滚、认证插件残留、连接参数没调、或 Hyperf 的 PDO 配置仍按高版本逻辑在跑。直接改 composer.json 降 hyperf/database 版本，大概率会触发依赖链崩坏。
MySQL 从 8.0 降级到 5.7 后 Hyperf 连不上怎么办
典型现象是启动时报 PDOException: SQLSTATE[HY000] [1045] Access denied for user 或日志里反复出现 Authentication plugin 'caching_sha2_password' cannot be loaded —— 这说明 MySQL 服务端已切回 mysql_native_password，但 Hyperf 连接时仍尝试用旧插件握手。
- 登录 MySQL 执行：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES; - 检查 Hyperf 的
config/autoload/databases.php中是否显式设置了'options' => [PDO::ATTR_EMULATE_PREPARES => true]，降级后建议加上，避免预处理语句解析失败 - 确认
php.ini中的mysql.default_socket或mysqli.default_socket指向的是 5.7 实例的 socket 路径（比如/var/run/mysqld/mysqld.sock），而非 8.0 的路径
Hyperf 3.x 项目要兼容 MySQL 5.7，哪些组件必须锁定版本
Hyperf 3.1+ 默认适配 MySQL 8.0+ 的特性（如 CTE、窗口函数、JSON 函数返回类型），若底层 DB 是 5.7，部分 Query Builder 生成的 SQL 会直接报错，比如 WITH RECURSIVE 或 JSON_EXTRACT(..., '$.key') 在 5.7 不支持。
- 锁定
hyperf/database到"^3.1.0"（别用^3.4，它默认启用 8.0 兼容开关） - 禁用
hyperf/db-connection的自动 schema 探测：在配置中设'auto_detect' => false，避免启动时执行SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS触发 5.7 不支持的元数据字段 - 手动替换掉使用了 MySQL 8.0 专属函数的自定义查询，例如把
JSON_CONTAINS改成LIKE '%value%'（需评估语义等价性）
降级后 Hyperf 报 “Too many connections” 或连接池卡死
这不是连接数真超限，而是 MySQL 5.7 的 wait_timeout（默认 28800 秒）和 Hyperf 连接池的 pool.max_idle_time（默认 60 秒）严重不匹配，导致大量连接被服务端主动断开，但 Hyperf 还以为它们活着，下次复用时抛出 PDOException: MySQL server has gone away。
- 调整 Hyperf 配置：
'pool' => ['max_idle_time' => 20.0, 'wait_timeout' => 2.0]（比 MySQL 的wait_timeout小至少 10 秒） - 同步修改 MySQL 的
my.cnf：wait_timeout = 30、interactive_timeout = 30，让两端 timeout 值接近 - 加健康检查：在
pool配置里启用'checker' => ['interval' => 10]，让连接池定期 ping，提前剔除失效连接
真正麻烦的从来不是版本数字本身，而是 MySQL 服务端行为变化（比如插件、timeout、SQL 模式）和 Hyperf 客户端配置之间那几毫秒的错位。每次降级前，先在测试环境跑一遍 mysqldump --no-create-info --skip-extended-insert your_db | head -1000 | php -r "echo json_encode(file_get_contents('php://stdin'));"，确认 dump 出的数据能被 Hyperf 的 ORM 正常解析——这比看文档更早暴露兼容性断裂点。
