Python操作MySQL插入失败：ID自增但无条目新增如何解决？

我来帮你梳理下这个问题的核心原因，以及对应的解决办法：

1. 事务未提交（最可能的原因） #

MySQLdb 连接默认是开启事务且不自动提交的状态。当你执行 qServer.execute() 后，如果没有手动提交事务，数据库会在会话结束时自动回滚这个插入操作。但自增主键的计数器是即时更新的（不管事务是否提交），所以你会看到 ID 数值增加，但实际数据并没有写入表中。而手动操作时，MySQL 客户端默认是自动提交事务的，所以不会出现这个问题。

解决方法： #

• 执行插入语句后，手动调用提交方法：

  qServer.execute(qString)
  qConn.commit()  # 关键：提交事务
  

• 或者在创建连接时直接开启自动提交：

  qConn = MySQLdb.connect(host="...", user="...", passwd="...", db="...", autocommit=True)
  

2. SQL 语句拼接导致的语法错误（隐藏坑） #

你使用 str.format() 拼接 SQL 语句，如果 name 或 ts3_uid 包含特殊字符（比如单引号 '、反斜杠 \），会直接破坏 SQL 语法，导致插入失败。但因为你没有捕获 execute() 的异常，所以根本不知道插入出错了，只会看到 ID 自增但无数据的现象。

解决方法：使用参数化查询（同时避免 SQL 注入） #

永远不要手动拼接 SQL 语句，改用 MySQLdb 支持的参数化查询，用 %s 作为占位符，让驱动自动处理特殊字符和类型转换：

# 用 %s 作为占位符，不要加引号
qString = "INSERT INTO TS3_STAMM_1 (name, ts3_uid, points) VALUES (%s, %s, %s)"
# 第二个参数是元组，传入对应的值
qServer.execute(qString, (name, uid, pnts))
qConn.commit()  # 别忘了提交事务

3. 未捕获插入阶段的异常 #

你的代码只捕获了连接数据库时的 OperationalError，但插入操作失败时会抛出其他类型的异常（比如 ProgrammingError 语法错误），这些异常没有被捕获，导致你无法及时发现问题所在。

解决方法：给插入逻辑添加异常捕获 #

try:
    qString = "INSERT INTO TS3_STAMM_1 (name, ts3_uid, points) VALUES (%s, %s, %s)"
    qServer.execute(qString, (name, uid, pnts))
    qConn.commit()
    print("插入成功")
except Exception as e:
    print(f"插入失败：{str(e)}")
    qConn.rollback()  # 回滚错误的事务

总结 #

优先检查事务提交的问题，这是最常见的原因；同时替换成参数化查询，既解决特殊字符的语法问题，又能避免 SQL 注入风险；最后加上异常捕获，方便排查后续可能出现的问题。

内容的提问来源于stack exchange，提问作者JH_WK