关键在于环境干净、配置精简、验证直接：先确认MySQL服务运行且127.0.0.1可连，禁用SSL选项，host设为127.0.0.1，再用php bin/hyperf.php db:query "SELECT 1"一键验证。
在 Linux 环境下快速验证 Hyperf 是否能连上 MySQL，关键不是堆配置，而是用最小可行路径排除干扰。重点在于：环境干净、配置精简、验证直接。
确认 MySQL 服务已就绪
先确保 MySQL 正在运行且允许本地连接：
- 执行 sudo systemctl status mysql 或 sudo service mysqld status，确认服务 active（running）
- 用命令行直连测试：mysql -u root -p -h 127.0.0.1 -P 3306（注意用 127.0.0.1 而非 localhost，避免 Unix socket 干扰）
- 成功登录后，执行 SELECT VERSION(), @@hostname; 和 SHOW VARIABLES LIKE 'have_ssl';，确认版本兼容（≥5.7）、SSL 状态（开发环境建议为 DISABLED 或 NO）
精简 Hyperf 数据库配置
编辑 config/autoload/databases.php，只保留最核心字段，禁用所有 SSL 相关项：
kashen-mysql DDLtoExcel
下载
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 删除 PDO::MYSQL_ATTR_SSL_CA、PDO::MYSQL_ATTR_SSL_CERT 等全部 SSL 选项
- 在 options 数组中明确加入：PDO::MYSQL_ATTR_SSL_MODE => PDO::MYSQL_ATTR_SSL_MODE_DISABLED
- 确保 host 是 127.0.0.1（非 localhost），port 显式写为 3306
- 临时把 pool.max_connections 设为 2，避免连接池干扰初始验证
用 CLI 命令一键验证连通性
不启动 HTTP 服务，直接用 Hyperf 自带命令触发数据库连接：
- 执行：php bin/hyperf.php db:query "SELECT 1 as ok"
- 若返回结果类似 [{"ok":1}]，说明连接成功、查询执行正常
- 若报错，优先看错误信息是否含 SSL、Connection refused 或 Access denied——分别对应证书配置、端口/防火墙、账号权限问题
- 加 -v 参数可查看完整 DSN：php bin/hyperf.php db:query "SELECT 1" -v
补充检查项（5 秒内可完成）
遇到连接失败时，快速过一遍这些点：
- telnet 127.0.0.1 3306 —— 验证端口是否可达（如不通，检查 MySQL 是否监听 TCP、防火墙是否放行）
- grep -r "bind-address" /etc/mysql/ —— 确保没配成 127.0.0.1 以外的地址或 skip-networking
- mysql -u your_user -p -h 127.0.0.1 —— 用应用同名账号密码再试一次，确认权限无误（尤其注意 host 是 % 还是 localhost）
