php连接mysql连不上本地服务_php本地mysql连不上排查【方案】

最常见原因是参数错误或认证插件不兼容；需检查 mysqli_connect() 参数与返回值，用 mysqli_connect_error() 输出错误，验证 MySQL 服务、端口、用户权限、认证插件及 PHP mysqli 扩展是否启用。 检查 的参数和返回值 连不上最常见原因是参数写错，比如把 写成 却没开 TCP 连接，或端口不是默认 3306。PHP 默认用 socket 连 ，但 MySQL 8.0+ 可能禁用了匿名用户或改了认证插件，导致空密码或旧用户直接被拒。 实操建议： 立即学习 “ PHP免费学习笔记（深入） ”； 先用 强制走 TCP，绕过 socket 配置问题 检查 返回值：如果返回 ，立刻加 打印错误，别只看白屏 确认用户名密码是否真能登录：在终端执行 ，输密码看能否进；若提示 ，说明账号权限或认证方式不匹配 确认 MySQL 服务状态和绑定地址 本地连不上，第一反应不该是改 PHP 代码，而是确认 MySQL 进程真在跑、且监听了预期地址。Windows 下服务可能没启动， mac OS/Linux 下可能被 brew 或 docker 的同名服务抢占端口。 实操建议： 立即学习 “ PHP免费学习笔记（深入） ”； Windows：打开任务管理器 → 服务页，查 或你起的服务名是否“正在运行”；或命令行运行 macOS/Linux：运行 看进程是否存在；再运行 确认端口被谁占着 检查 MySQL 配置文件（ 或 ）里是否有 （正常），但绝不能是 或空值（某些版本会拒绝 IPv4 连接） 处理 MySQL 8.0+ 默认认证插件变更 PHP 7.4 及更早版本的 扩展不支持 插件，而 MySQL 8.0 默认就用它。结果就是账号密码没错，连接却静默失败，错误信息可能是 。 Docker Sandbox 创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。 下载 实操建议： 立即学习 “ PHP免费学习笔记（深入） ”； 临时方案：登录 MySQL 后执行 ，然后 长期方案：升级 PHP 到 8.0+ 并确保编译时启用了 和对应 OpenSSL 支持；或在连接前加 避免卡死 验证插件：执行 ，确认 plugin 是 检查 PHP 的 扩展是否启用 哪怕 MySQL 服务全 OK，PHP 没装或没启 扩展，调用 也会报 —— 这类错误容易被当成 MySQL 问题，其实根本没走到连接逻辑。 实操建议： 立即学习 “ PHP免费学习笔记（深入） ”； 运行 （命令行）或 页面搜索 “ mysql i”，确认扩展已加载 Windows 用户注意 里是否取消了 前的分号；macOS 用 brew 安装的 PHP，可能需手动链接扩展配置 CLI 和 Web SAPI 的 可能不同： 查 CLI 路径， 里看 “Loaded Configuration File” 查 Web 路径 真正卡住的地方往往不在连接语句本身，而在 MySQL 认证机制、socket 文件路径、或 PHP 扩展加载层级这些“看不见”的链路上。每次排查，优先确认服务进程、端口、插件、扩展这四层是否全部对齐，比反复改 参数更省时间。