本文旨在解决使用 PyMySQL 连接 MariaDB 数据库时遇到的 TypeError: __init__() takes 1 positional argument but 5 were given 错误。通过明确指定连接参数，可以避免此错误，并成功建立数据库连接。本文将提供详细的连接示例和注意事项，帮助开发者快速解决类似问题。
在使用 PyMySQL 连接 MariaDB 或 MySQL 数据库时，可能会遇到 TypeError: __init__() takes 1 positional argument but 5 were given 错误。 这个错误通常表明你在调用 pymysql.connect() 函数时，参数传递方式不正确。
问题原因
PyMySQL 的 connect() 函数期望接收的是键值对形式的参数，而不是位置参数。这意味着你需要明确指定每个参数的名称，例如 host、user、password 和 database。
解决方案
要解决此问题，请确保你在调用 connect() 函数时，使用关键字参数传递数据库连接信息。以下是一个正确的连接示例：
import pymysql
try:
connection = pymysql.connect(
host='your_host',
user='your_user',
password='your_password',
database='your_database',
charset='utf8mb4', # 可选：指定字符集
cursorclass=pymysql.cursors.DictCursor # 可选：指定游标类型
)
print("数据库连接成功！")
# 在这里执行数据库操作
# 例如：
# with connection.cursor() as cursor:
# sql = "SELECT * FROM your_table"
# cursor.execute(sql)
# results = cursor.fetchall()
# print(results)
except pymysql.MySQLError as e:
print(f"数据库连接失败：{e}")
finally:
if connection:
connection.close()
print("数据库连接已关闭。")代码解释：
- host: 数据库服务器的主机名或 IP 地址。
- user: 连接数据库的用户名。
- password: 用户的密码。
- database: 要连接的数据库名称。
- charset: （可选）指定连接的字符集，推荐使用 utf8mb4 以支持更广泛的字符。
- cursorclass: （可选）指定游标类型。pymysql.cursors.DictCursor 返回字典形式的结果，方便操作。
注意事项：
- 异常处理： 使用 try...except...finally 块来处理可能出现的数据库连接错误，例如用户名或密码错误、数据库不存在等。
- 关闭连接： 务必在完成数据库操作后关闭连接，以释放资源。 使用 finally 块确保即使发生异常也能关闭连接。
- 安全性： 不要将数据库连接信息硬编码在代码中。 建议使用环境变量或配置文件来存储敏感信息。
- 游标类型： 根据你的需求选择合适的游标类型。 pymysql.cursors.DictCursor 是一个常用的选择，因为它返回字典形式的结果，便于访问数据。
- 字符集： 确保数据库、表和连接的字符集一致，以避免乱码问题。 推荐使用 utf8mb4 字符集。
总结
通过使用关键字参数传递连接信息，可以避免 PyMySQL 连接时出现的 TypeError 错误。 同时，良好的异常处理和资源管理是编写健壮数据库应用程序的关键。 希望本文能够帮助你成功连接 MariaDB 或 MySQL 数据库，并顺利进行后续的开发工作。
