关键在于环境干净、配置精简、验证直接：先确认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 相关项：

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• 删除 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）