Python 中通过数据库驱动（如 PyMySQL、psycopg2、pymongo 等）连接数据库时，设置数据库参数是必要且关键的步骤，它决定了连接的行为、性能和正确性 [ref_2][ref_5]。这些参数通常在连接阶段通过一个 `config` 字典或连接字符串进行配置 [ref_5][ref_6]。 ### 一、核心数据库连接参数及其作用 数据库连接的核心参数通常包括网络地址、认证信息、数据库名称以及控制连接行为的选项。以下是各参数及其典型用途的总结 [ref_2][ref_5][ref_6]： | 参数类别 | 参数名 | 典型值示例 | 作用说明 | | :--- | :--- | :--- | :--- | | **网络与地址** | `host` | `‘localhost’`, `‘127.0.0.1’` | 数据库服务器地址。 | | | `port` | `3306` (MySQL), `5432` (PostgreSQL) | 数据库服务监听端口。 | | **认证信息** | `user` | `‘root’` | 连接数据库的用户名。 | | | `password` | `‘your_password’` | 对应用户的密码。 | | | `database` | `‘test_db’` | 连接后默认使用的数据库名。 | | **连接行为** | `charset` | `‘utf8mb4’` | **至关重要**，用于指定客户端字符集，避免中文乱码等问题 [ref_5]。 | | | `autocommit` | `True` 或 `False` | 是否自动提交事务。 | | | `connect_timeout` | `10` | 连接超时时间（秒）。 | ### 二、设置数据库参数的主要方法 #### 1. 在代码中直接构造连接参数字典 这是最直接的方法，适用于快速测试或参数固定的场景。你可以在创建连接对象时直接传入一个包含所有参数的字典 [ref_5][ref_6]。 ```python # 示例：连接MySQL数据库 import pymysql # 直接在代码中定义参数字典 config = { ‘host‘: ‘localhost‘, ‘port‘: 3306, ‘user‘: ‘test_user‘, ‘password‘: ‘secure_password‘, ‘database‘: ‘my_app_db‘, ‘charset‘: ‘utf8mb4‘, # 显式指定字符集，防止中文写入乱码 [ref_5] ‘autocommit‘: True, ‘connect_timeout‘: 5 } try: connection = pymysql.connect(**config) # 使用字典解包传递参数 print(“数据库连接成功!”) # ... 执行数据库操作 connection.close() except pymysql.MySQLError as e: print(f“连接数据库失败: {e}”) ``` #### 2. 从配置文件中读取参数（推荐） 将数据库参数剥离到配置文件（如 `.ini`, `.yaml`, `.env` 或 `.conf` 文件）中是生产环境的最佳实践。这样做提高了代码的灵活性、安全性和可维护性，便于在不同环境（开发、测试、生产）间切换配置 [ref_1][ref_4]。 **步骤1：创建配置文件** 创建一个 `config.ini` 文件，内容如下 [ref_1]： ```ini [database] host = localhost port = 3306 user = app_user password = your_secure_password_here database = production_db charset = utf8mb4 ; 可选的其他参数 ; autocommit = True ; pool_size = 5 ``` **步骤2：使用 Python 读取配置并建立连接** 使用 `configparser` 模块来解析 `.ini` 文件 [ref_1]。 ```python import pymysql import configparser # 创建配置解析器实例 config = configparser.ConfigParser() config.read(‘config.ini‘) # 读取配置文件 # 从配置文件的‘database‘节获取所有参数，并转换为字典 db_config = dict(config[‘database‘]) # 注意：configparser读取的值默认是字符串，需要转换port等数值类型 db_config[‘port‘] = int(db_config[‘port‘]) try: # 使用从配置文件读取的参数建立连接 connection = pymysql.connect(**db_config) print(f“成功连接到数据库: {db_config[‘database‘]}”) connection.close() except Exception as e: print(f“连接失败: {e}”) ``` #### 3. 使用连接池管理参数 对于高并发应用，使用连接池可以避免频繁创建和销毁连接的开销。连接池的初始化也需要配置数据库参数，且这些参数会被池中的所有连接共享 [ref_2]。 ```python # 示例：使用DBUtils库创建PyMySQL连接池 from dbutils.pooled_db import PooledDB import pymysql # 定义数据库连接参数 pool_config = { ‘creator‘: pymysql, # 指定使用的数据库驱动 ‘host‘: ‘localhost‘, ‘port‘: 3306, ‘user‘: ‘pool_user‘, ‘password‘: ‘pool_pass‘, ‘database‘: ‘pool_db‘, ‘charset‘: ‘utf8mb4‘, ‘maxconnections‘: 10, # 连接池最大连接数 ‘mincached‘: 2, # 初始化时创建的空闲连接数 ‘blocking‘: True, # 连接池满时是否阻塞等待 } # 创建连接池 pool = PooledDB(**pool_config) # 从池中获取连接 conn = pool.connection() cursor = conn.cursor() cursor.execute(“SELECT 1”) result = cursor.fetchone() print(result) cursor.close() conn.close() # 实际是将连接归还给连接池 ``` #### 4. 连接 MongoDB 等 NoSQL 数据库 设置参数的方式类似，通过字典传递。MongoDB 的连接参数可能有所不同 [ref_4]。 ```python # 示例：连接MongoDB from pymongo import MongoClient # 直接构造连接参数字典 mongo_config = { ‘host‘: ‘localhost‘, ‘port‘: 27017, ‘username‘: ‘mongo_user‘, # 如果启用认证 ‘password‘: ‘mongo_pass‘, ‘authSource‘: ‘admin‘, # 认证数据库 } client = MongoClient(**mongo_config) db = client[‘my_database‘] # 选择数据库 collection = db[‘my_collection‘] # 选择集合 # 插入数据示例 data = {“name“: “test“, “value“: 123} collection.insert_one(data) print(“数据插入成功”) ``` ### 三、关键参数详解与常见问题 1. **字符集参数 (`charset`)**: 这是导致中文乱码最常见的原因。必须确保 Python 客户端、数据库连接以及数据库表三者的字符集设置一致，通常推荐使用 `utf8mb4` 以支持完整的 Unicode（包括表情符号） [ref_5]。 2. **事务自动提交 (`autocommit`)**: 默认为 `False`，意味着执行 `INSERT`、`UPDATE` 等语句后需要手动执行 `connection.commit()` 才会生效。如果设置为 `True`，则每条语句都自动提交，在要求原子性的操作中需谨慎使用。 3. **环境变量与动态配置**: 对于密码等敏感信息，绝对**不要**硬编码在代码或配置文件中。应使用环境变量管理 [ref_2]。可以通过 `os.getenv()` 动态获取。 ```python import os import pymysql # 从环境变量读取敏感配置 db_params = { ‘host‘: os.getenv(‘DB_HOST‘, ‘localhost‘), # 第二个参数为默认值 ‘user‘: os.getenv(‘DB_USER‘), ‘password‘: os.getenv(‘DB_PASSWORD‘), # 密码从环境变量获取 ‘database‘: os.getenv(‘DB_NAME‘), ‘charset‘: ‘utf8mb4‘ } ``` **总结**：在 Python 中设置数据库参数是一项基础且关键的任务。最佳实践是**将参数存储在配置文件或环境变量中**，然后在代码中读取并使用这些参数来建立数据库连接或初始化连接池。始终明确指定 `charset` 等关键参数，可以避免后续许多棘手的编码和性能问题 [ref_1][ref_2][ref_5][ref_6]。