1. 连接到 MySQL 服务器：但不连接到任何特定的数据库，而是连接到服务器本身，这需要一个拥有足够权限（通常是 DROP DATABASE 权限）的数据库用户。
2. 创建一个游标：用于执行 SQL 命令。
3. 执行 DROP DATABASE SQL 语句：将数据库名称作为参数传入。
4. 提交更改：对于 DROP 这类 DDL（数据定义语言）操作，commit() 是必须的。
5. 关闭连接：释放资源。

下面我将分步讲解,并提供完整的代码示例、错误处理和最佳实践。

第 1 步：安装必要的库

如果你还没有安装 mysql-connector-python，请先使用 pip 安装：

pip install mysql-connector-python

第 2 步：编写 Python 脚本

我们将创建一个函数,接收数据库名称作为参数，并执行删除操作。

基础版本

这是一个最简单直接的版本,没有包含错误处理。

import mysql.connector
from mysql.connector import Error
def delete_database(db_name):
    """
    连接到 MySQL 服务器并删除指定的数据库。
    :param db_name: 要删除的数据库名称
    """
    connection = None
    cursor = None
    try:
        # 1. 连接到 MySQL 服务器
        # 注意：这里我们不指定 database 参数
        connection = mysql.connector.connect(
            host='localhost',      # 你的 MySQL 服务器地址
            user='your_username',  # 拥有 DROP 权限的用户名
            password='your_password' # 该用户的密码
        )
        if connection.is_connected():
            cursor = connection.cursor()
            # 2. 执行 DROP DATABASE SQL 语句
            # 使用 f-string 或 % 格式化来构建 SQL 语句
            # 注意：SQL 语句中最好使用反引号 ` 包裹数据库名，以防使用保留字
            sql_query = f"DROP DATABASE `{db_name}`"
            print(f"正在尝试删除数据库: {db_name}")
            cursor.execute(sql_query)
            # 3. 提交事务
            connection.commit()
            print(f"数据库 '{db_name}' 已成功删除。")
    except Error as e:
        # 4. 捕获并打印错误
        print(f"删除数据库时发生错误: {e}")
    finally:
        # 5. 确保关闭游标和连接
        if cursor:
            cursor.close()
        if connection and connection.is_connected():
            connection.close()
            print("MySQL 连接已关闭。")
# --- 使用示例 ---
if __name__ == "__main__":
    database_to_delete = 'test_db'  # 替换为你要删除的数据库名
    delete_database(database_to_delete)

第 3 步：代码解析和最佳实践

连接到服务器，而不是数据库

关键点在于 mysql.connector.connect() 函数中没有提供 database 参数，这是必须的，因为你要删除的那个数据库可能已经不存在，或者你甚至不应该有权限连接它（为了安全），你需要一个拥有全局管理权限（如 DROP）的用户来登录服务器。

# 错误示例：试图连接到即将被删除的数据库
# connection = mysql.connector.connect(
#     host='localhost',
#     user='your_username',
#     password='your_password',
#     database=db_name  # 不要这样做！
# )

安全地构建 SQL 语句

使用 f-string 或 来将数据库名插入 SQL 语句是可行的，但为了更安全，可以使用 cursor.execute() 的第二个参数（参数化查询），尽管对于 DROP DATABASE 这种不涉及用户输入的简单语句来说，直接构建 SQL 也是安全的。

# 方法一：直接构建 (简单直接)
sql_query = f"DROP DATABASE `{db_name}`"
cursor.execute(sql_query)
# 方法二：参数化查询 (更安全，但在此场景下略显繁琐)
# 这种方式对于数据库名字来说不常用，但对于表名等参数更推荐
sql_query = "DROP DATABASE `%s`"
cursor.execute(sql_query, (db_name,))

使用反引号 ` 包裹数据库名是一个好习惯，可以防止数据库名恰好是 MySQL 的保留字（如 order, group 等）而导致语法错误。

错误处理 (try...except)

数据库操作可能会因为多种原因失败,

• 连接失败：用户名、密码错误，或服务器未运行。
• 权限不足：执行脚本的用户没有 DROP DATABASE 权限。
• 数据库不存在：尝试删除一个不存在的数据库会抛出 mysql.connector.errors.DatabaseError 异常。

上面的代码通过 try...except Error 捕获了 mysql.connector 可能抛出的所有标准错误，并打印出友好的提示信息。

资源清理 (finally)

finally 块中的代码无论是否发生异常都会被执行，这是确保数据库连接和游标被正确关闭的最佳方式，可以防止资源泄漏。

第 4 步：增强版（更健壮的脚本）

一个更健壮的脚本应该包含更多的检查和更详细的错误信息。

import mysql.connector
from mysql.connector import Error
def delete_database_safely(db_name):
    """
    安全地删除 MySQL 数据库，包含存在性检查和详细的错误处理。
    :param db_name: 要删除的数据库名称
    :return: 如果成功删除返回 True，否则返回 False
    """
    connection = None
    cursor = None
    try:
        # 1. 连接到 MySQL 服务器
        connection = mysql.connector.connect(
            host='localhost',
            user='your_username',
            password='your_password'
        )
        if not connection.is_connected():
            print("无法连接到 MySQL 服务器。")
            return False
        cursor = connection.cursor()
        # 2. (可选但推荐) 首先检查数据库是否存在
        cursor.execute(f"SHOW DATABASES LIKE '{db_name}'")
        result = cursor.fetchone()
        if not result:
            print(f"数据库 '{db_name}' 不存在，无需删除。")
            return True # 视为成功，因为目标状态（不存在）已经达成
        # 3. 如果存在，则执行删除
        print(f"数据库 '{db_name}' 存在，正在执行删除...")
        sql_query = f"DROP DATABASE `{db_name}`"
        cursor.execute(sql_query)
        connection.commit()
        print(f"成功删除数据库 '{db_name}'。")
        return True
    except Error as e:
        print(f"操作失败: {e}")
        return False
    finally:
        if cursor:
            cursor.close()
        if connection and connection.is_connected():
            connection.close()
            print("MySQL 连接已关闭。")
# --- 使用示例 ---
if __name__ == "__main__":
    database_to_delete = 'test_db'
    if delete_database_safely(database_to_delete):
        print("数据库删除任务完成。")
    else:
        print("数据库删除任务失败。")

安全警告 ⚠️

删除数据库是一个不可逆的操作！ 数据库中的所有数据、表、视图、存储过程等都将被永久删除，并且无法恢复。

在执行此操作前,请务必：

1. 确认数据库名称正确无误，特别是当数据库名是通过变量或用户输入获取时。
2. 考虑先进行备份，如果只是想清空数据而不是删除整个数据库，可以考虑 DROP TABLE 或 TRUNCATE TABLE。
3. 谨慎使用脚本，确保你有足够的权限和信心执行此操作。