PHP 连接 Docker MySQL 容器失败的常见原因与正确配置方案-php教程-PHP中文网

PHP 连接 Docker MySQL 容器失败的常见原因与正确配置方案

本文详解 php 脚本无法连接 docker 化 mysql 的核心问题：用户主机权限不匹配（如 user01@'localhost' 无法访问来自 10.10.10.10 的连接），并提供完整、可复现的端到端解决方案，涵盖容器启动、用户授权、php 连接代码及调试要点。

本文详解 php 脚本无法连接 docker 化 mysql 的核心问题：用户主机权限不匹配（如 user01@'localhost' 无法访问来自 10.10.10.10 的连接），并提供完整、可复现的端到端解决方案，涵盖容器启动、用户授权、php 连接代码及调试要点。

在 Docker 环境中，PHP 应用通过 TCP 连接 MySQL 容器时，MySQL 用户的主机名（Host）必须与客户端实际发起连接的 IP 地址严格匹配——这是绝大多数“Access denied”错误的根本原因。你遇到的报错：

Access denied for user 'user01'@'10.10.10.10' (using password: YES)

明确指出：MySQL 接收到了来自 IP 10.10.10.10 的连接请求，但数据库中仅存在 user01@'localhost' 用户，而 MySQL 不会自动将 localhost 视为任意 IP 的通配符（尤其在 TCP 连接下，localhost 通常仅匹配 Unix socket 或 127.0.0.1 的本地回环，且不等价于其他 IP）。你的 PHP 脚本运行在宿主机（Ubuntu），Docker 网络栈将该连接源地址映射为容器网络内的某个地址（如 10.10.10.10，实际值取决于 Docker 默认 bridge 网络配置），因此必须显式授权该来源 IP。

✅ 正确的用户授权方式（关键修正）

进入正在运行的 MySQL 容器执行以下命令（替换为你的容器 ID 或名称）：

docker exec -it myMYSQL mysql -u root -ppassword123

然后在 MySQL CLI 中执行：

Dolphindb Docker

自动化 DolphinDB Docker 部署，支持自动架构检测（ARM64/x86_64），智能内存分配（50% 规则）以及完整数据持久化。

下载

-- 删除旧的不匹配用户（可选，避免冲突）
DROP USER IF EXISTS 'user01'@'localhost';

-- 创建适配 TCP 连接的新用户：使用 '%' 通配符（推荐开发环境）或指定宿主机 IP
CREATE USER 'user01'@'%' IDENTIFIED BY 'password123';

-- 授予对目标数据库的全部权限
GRANT ALL PRIVILEGES ON myDB.* TO 'user01'@'%';

-- 刷新权限使生效
FLUSH PRIVILEGES;

-- 验证（应看到 'user01'@'%'）
SELECT User, Host FROM mysql.user WHERE User = 'user01';

? 为什么用 '%'？
'%' 表示允许从任意主机 IP 连接，完美适配 Docker 宿主机与容器间动态网络地址（包括 127.0.0.1、172.17.0.1、10.10.10.10 等）。生产环境可收紧为具体宿主机 IP（如 'user01'@'172.17.0.1'），但开发阶段 % 最简洁可靠。

✅ 修复后的 PHP 连接脚本

你的原始脚本逻辑基本正确，但需补充两点：端口参数位置修正 + 错误处理增强。以下是优化后的完整代码：

<?php $servername = "127.0.0.1";   // 宿主机回环，经 -p 52000:3306 映射到容器
$username   = "user01";
$password   = "password123";
$database   = "myDB";
$mysqlPort  = 52000;         // 注意：此处应为整数，非字符串

// 建立连接（端口参数位置：第5位是 port，第6位是 socket，留空即可）
$conn = mysqli_connect($servername, $username, $password, $database, $mysqlPort);

// 检查连接是否成功
if (!$conn) {
    $error = mysqli_connect_error();
    $errno = mysqli_connect_errno();
    die("❌ 连接失败（错误码 {$errno}）: {$error}");
}

echo "✅ 成功连接到 MySQL 容器！\n";

// 可选：验证数据库选择
if (!mysqli_select_db($conn, $database)) {
    die("❌ 无法选择数据库 {$database}: " . mysqli_error($conn));
}

// 测试查询（可选）
$result = mysqli_query($conn, "SELECT VERSION() as ver");
if ($result && $row = mysqli_fetch_assoc($result)) {
    echo "MySQL 版本: " . $row['ver'] . "\n";
}

mysqli_close($conn);
?>

⚠️ 关键注意事项与调试技巧

端口映射验证：确保容器确实监听了宿主机端口。运行 sudo netstat -tuln | grep :52000，应看到 127.0.0.1:52000 处于 LISTEN 状态。
防火墙检查：Ubuntu 的 ufw 可能拦截本地端口，临时禁用测试：sudo ufw disable（测试后记得恢复）。
MySQL 绑定地址：Docker MySQL 默认绑定 0.0.0.0:3306（接受所有网络接口），无需额外配置；若自定义镜像，请确认 bind-address = 0.0.0.0 在 my.cnf 中。
避免 localhost 主机名陷阱：在 PHP 中使用 "localhost" 会触发 Unix socket 连接（绕过端口映射），导致失败。务必使用 "127.0.0.1" 强制 TCP。
容器健康检查：运行 docker ps 确认 myMYSQL 容器状态为 Up，且端口列显示 0.0.0.0:52000->3306/tcp。