pymysql.err.ProgrammingError: (1064, "You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ',\n PRIMARY KEY (自编码)' at line 3")

### PyMySQL 中 SQL 语法错误的解决方案 #### 错误原因分析 `pymysql.err.ProgrammingError: (1064, 'You have an error in your SQL syntax')` 是由于 SQL 语句存在语法问题所致。具体来说，在定义表结构时，如果涉及到 `PRIMARY KEY` 和自增字段（如 `AUTO_INCREMENT`），则需要严格遵循 MySQL 的语法规则[^1]。常见的错误包括但不限于： - 字段名称或关键字未被正确识别。 - 缺少必要的约束条件，例如 `UNSIGNED` 或 `NOT NULL`。 - 自增字段未正确定义为整数类型。 --- #### 正确的 SQL 表结构设计 以下是创建带有 `PRIMARY KEY` 和自增字段的 SQL 表的正确方式： ```sql CREATE TABLE example_table ( id INT(10) UNSIGNED AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) NOT NULL DEFAULT '', description TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); ``` 在此示例中需要注意的关键点如下： - `id` 字段被定义为无符号整数 (`INT(10) UNSIGNED`) 并启用了自动增长功能 (`AUTO_INCREMENT`)。 - 将 `id` 设置为主键 (`PRIMARY KEY`)。 - 对于其他字段，默认值使用单引号包裹字符串常量[^1]。 --- #### Python 使用 PyMySQL 创建表并插入数据 以下是一个完整的 Python 脚本，演示如何通过 PyMySQL 连接到数据库、执行建表语句以及插入记录： ```python import pymysql # 数据库连接参数 db_config = { "host": "localhost", "port": 3306, "user": "root", "password": "your_password", "database": "test_db", "charset": "utf8mb4" } try: # 建立连接 connection = pymysql.connect(**db_config) with connection.cursor() as cursor: # 创建表 create_table_sql = """ CREATE TABLE IF NOT EXISTS users ( user_id INT(10) UNSIGNED AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL DEFAULT '', email VARCHAR(100), created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); """ cursor.execute(create_table_sql) # 插入数据 insert_data_sql = """ INSERT INTO users (username, email) VALUES (%s, %s); """ data_to_insert = ("Alice", "[email protected]") cursor.execute(insert_data_sql, data_to_insert) # 提交事务 connection.commit() except Exception as e: print(f"An error occurred: {e}") finally: # 关闭连接 if connection.open: connection.close() ``` 上述脚本实现了以下几个目标： - 使用字典存储数据库连接配置以便重用。 - 利用占位符 `%s` 动态传递参数至 SQL 查询中，防止 SQL 注入风险。 - 确保每次操作完成后提交事务，并在异常发生时打印详细的错误信息。 --- #### SQLAlchemy 替代方案 如果希望简化数据库交互逻辑，可以考虑使用 SQLAlchemy 库替代原生 PyMySQL。SQLAlchemy 支持 ORM（对象关系映射）模式，能够更直观地管理复杂的数据库模型[^2]。 ##### 安装依赖 首先确保已安装 SQLAlchemy 和适配器包： ```bash pip install sqlalchemy pymysql ``` ##### 示例代码 以下是如何借助 SQLAlchemy 实现相同功能的一个例子： ```python from sqlalchemy import Column, Integer, String, TIMESTAMP, func, create_engine from sqlalchemy.ext.declarative import declarative_base from sqlalchemy.orm import sessionmaker Base = declarative_base() class User(Base): __tablename__ = 'users' user_id = Column(Integer, primary_key=True, autoincrement=True) username = Column(String(50), nullable=False, default='') email = Column(String(100)) created_at = Column(TIMESTAMP, server_default=func.now()) # 初始化引擎 engine = create_engine('mysql+pymysql://root:your_password@localhost/test_db') # 创建表 Base.metadata.create_all(engine) # 开始会话 Session = sessionmaker(bind=engine) session = Session() # 添加新用户 new_user = User(username="Bob", email="[email protected]") session.add(new_user) session.commit() print("User added successfully!") ``` 该方法的优势在于其声明式的风格使得代码更加清晰易懂，同时也提供了更高的抽象层次来处理复杂场景下的需求。 --- ###