无法远程连接docker中的mysql数据库

原创

mob64ca12f66e6c 2025-04-13 04:36:37 ©著作权

文章标签 MySQL 数据库 Docker 文章分类 Docker 云计算

©著作权归作者所有：来自51CTO博客作者mob64ca12f66e6c的原创作品，请联系作者获取转载授权，否则将追究法律责任

无法远程连接docker中的mysql数据库，常常会让开发者困扰。今天我将系统地记录解决这个问题的过程，帮助大家在类似情况中采取必要的措施。

环境准备

在开始之前，确保你的环境已经搭建完毕。以下是我们所需的依赖项及其版本兼容性：

组件	最小版本	建议版本
Docker	19.x	20.x
MySQL	5.7	8.0
Docker Compose	1.25.x	1.29.x
Python	3.6	3.9
Java	8	11

接下来，通过下面的 mermaid 四象限图，展示我们的技术栈匹配度：

quadrantChart
    title 技术栈匹配度
    x-axis 学习难度
    y-axis 业务价值
    "Docker": [2, 3]
    "MySQL": [3, 4]
    "Python": [2, 2]
    "Java": [4, 3]

确保所有组件都已安装完毕，如果没有，请查阅相应的依赖安装指南。

集成步骤

我们需要完成以下步骤才能实现远程连接到 Docker 中的 MySQL 数据库。下面是数据交互流程的流程图：

flowchart TD
    A[应用程序] --> B[远程连接请求]
    B --> C[Docker容器网络]
    C --> D[MySQL服务]
    D --> E[连接响应]
    E --> B
    E --> A

这里提供的示例代码展示了如何用 Python、Java 和 Bash 代码连接 Docker 上的 MySQL 数据库：

# Python连接MySQL
import mysql.connector

cnx = mysql.connector.connect(user='yourusername', password='yourpassword', host='localhost', database='yourdatabase')
cursor = cnx.cursor()
query = "SELECT * FROM yourtable"
cursor.execute(query)

for row in cursor.fetchall():
    print(row)

cursor.close()
cnx.close()

// Java连接MySQL
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;

class MySQLExample {
    public static void main(String[] args) {
        try {
            Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/yourdatabase", "yourusername", "yourpassword");
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery("SELECT * FROM yourtable");
            while (rs.next()) {
                System.out.println(rs.getString(1));
            }
            conn.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

# Bash连接MySQL
mysql -u yourusername -p -h 127.0.0.1 -P 3306 yourdatabase -e "SELECT * FROM yourtable;"

配置详解

在连接 MySQL 数据库之前，需要正确配置 Docker 中的 MySQL。下面是一个配置文件模板示例，使用 YAML 格式描述 MySQL 容器的配置：

version: '3.1'

services:
  db:
    image: mysql:latest
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: yourpassword
      MYSQL_DATABASE: yourdatabase
      MYSQL_USER: yourusername
      MYSQL_PASSWORD: yourpassword
    ports:
      - "3306:3306"

在此配置中，重要的参数对照表如下：

参数	描述
`MYSQL_ROOT_PASSWORD`	MySQL的根密码
`MYSQL_DATABASE`	创建的数据库名称
`MYSQL_USER`	MySQL用户名称
`MYSQL_PASSWORD`	MySQL用户的密码
`ports`	容器端口映射

实战应用

为了让这个过程更具体，我将展示一个端到端的应用案例。

> 本案例展示了如何通过Python程序远程连接 Docker 中的 MySQL 数据库，并进行基本的查询操作，从而实现数据的应用价值。

创建 Docker 容器，配置并运行 MySQL 数据库后，可以通过上述的 Python 代码连接数据库，进行数据查询。

排错指南

在连接 Docker 中的 MySQL 数据库时，常见的报错信息包括：

Access denied for user 'yourusername'@'localhost'
Can't connect to MySQL server on '127.0.0.1' (111)
Unknown database 'yourdatabase'

我们可以使用以下思维导图来排查这些问题的根源：

mindmap
  root((连接MySQL时的常见问题))
    AccessDenied
      用户名错误
      密码错误
      权限不足
    ConnectionError
      容器未启动
      地址或端口错误
    UnknownDatabase
      数据库未创建
      数据库名称错误