使用 Python 连接 AWS MySQL 数据库的教程-Python教程-PHP中文网

使用 Python 连接 AWS MySQL 数据库的教程

聖光之護

发布： 2025-10-04 12:18:02

原创

848人浏览过

使用 python 连接 aws mysql 数据库的教程

本文旨在帮助开发者解决在使用 Python 连接 AWS RDS MySQL 数据库时遇到的常见问题。通过配置 VPC 网络、安全组规则以及检查连接参数，确保 Python 代码能够成功连接到数据库。文章将提供示例代码和详细步骤，帮助读者快速排除连接故障。

前提条件

在开始之前，请确保你已经完成了以下准备工作：

拥有一个 AWS 账号，并且已经创建了一个 RDS MySQL 数据库实例。
安装了 Python 环境，并且安装了 mysql-connector-python 库。可以使用 pip install mysql-connector-python 命令进行安装。
了解 AWS VPC (Virtual Private Cloud) 的基本概念。

步骤一：VPC 网络配置

当需要从任何地方连接到 RDS 实例时，需要确保你的连接源（例如 EC2 实例、ECS 容器或 Lambda 函数）与 RDS 实例位于同一个 VPC 中。这是确保网络连通性的关键步骤。

步骤二：安全组配置

安全组充当虚拟防火墙，控制进出 RDS 实例的流量。你需要配置安全组规则，允许来自你的连接源的流量到达 RDS 实例的 3306 端口（MySQL 的默认端口）。

立即学习“Python免费学习笔记（深入）”；

找到 RDS 实例的安全组： 在 AWS RDS 控制台中，找到你的 MySQL 数据库实例，然后查看其关联的安全组。
添加入站规则： 在安全组的入站规则中，添加一条规则，允许来自你的连接源的流量。
- 类型： 选择 "MySQL/Aurora" 或 "Custom TCP"。
- 端口范围： 输入 3306。
- 来源： 根据你的连接源选择合适的选项。
  - 如果你的连接源是 EC2 实例，可以选择 EC2 实例的安全组。
  - 如果你的连接源是特定的 IP 地址，可以选择 "Custom" 并输入 IP 地址/CIDR。
  - 注意： 为了方便测试，可以暂时允许来自任何 IP 地址的连接（0.0.0.0/0），但在生产环境中，请务必限制为特定的 IP 地址或安全组。

步骤三：Python 代码示例

以下是一个使用 Python 连接 AWS RDS MySQL 数据库的示例代码：

SpeakingPass-打造你的专属雅思口语语料

使用chatGPT帮你快速备考雅思口语，提升分数

查看详情

import mysql.connector

db_config = {
    'user': 'db_user',
    'password': 'user_password',
    'host': 'your_rds_endpoint',
    'database': 'db_name',
    'port': 3306,
    'connection_timeout': 10
}

try:
    connection = mysql.connector.connect(**db_config)

    if connection.is_connected():
        print("Connected to the MySQL database")
        db_Info = connection.get_server_info()
        print("Server version:", db_Info)
        cursor = connection.cursor()
        cursor.execute("select database();")
        db_name = cursor.fetchone()
        print("You are connected to database: ", db_name)

except mysql.connector.Error as err:
    print(f"Error: {err}")

finally:
    if 'connection' in locals() and connection.is_connected():
        cursor.close()
        connection.close()
        print("Connection closed")

登录后复制

代码解释：

db_config 字典包含了连接数据库所需的配置信息，例如用户名、密码、主机名、数据库名和端口号。
mysql.connector.connect(**db_config) 尝试建立与数据库的连接。
connection.is_connected() 检查连接是否成功建立。
try...except...finally 块用于处理连接过程中可能出现的异常，并在最后关闭连接。

注意事项：

将 your_rds_endpoint 替换为你的 RDS 实例的终端节点（Endpoint）。可以在 AWS RDS 控制台中找到该终端节点。
将 db_user、user_password 和 db_name 替换为你的数据库的实际用户名、密码和数据库名。
connection_timeout 参数设置了连接超时时间，单位为秒。如果连接时间超过此时间，将抛出异常。

步骤四：常见问题排查

连接超时： 如果出现连接超时错误（例如 Error: 2003 (HY000): Can't connect to MySQL server），请检查 VPC 网络配置和安全组规则是否正确。确保你的连接源可以访问 RDS 实例的 3306 端口。
身份验证错误： 如果出现身份验证错误（例如 Error: 1045 (28000): Access denied for user），请检查用户名和密码是否正确。
拼写错误： 仔细检查 db_config 字典中的配置信息，确保没有拼写错误。