Python中DataFrame写入SQLite失败：表已存在错误

以下是几种常见原因和对应的解决办法：

1. 数据库连接路径错误 #

你可能连接到了一个未留意的SQLite文件（比如当前目录下的同名文件、或绝对路径写错）。先确认连接的数据库是否为目标文件：

# 打印当前连接的所有数据库路径
print(condb.execute("PRAGMA database_list;").fetchall())

如果返回路径不符合预期，修正sqlite3.connect()的路径参数即可。

2. 未提交事务导致元数据不一致 #

如果之前手动执行过CREATE TABLE或DROP TABLE操作，但没调用condb.commit()，SQLite的事务会处于未提交状态，导致元数据状态混乱。先提交所有未完成的事务：

condb.commit()

之后重新运行df.to_sql语句。

3. pandas版本存在bug #

部分旧版pandas处理SQLite的if_exists参数时存在逻辑问题，会错误地在append模式下抛出“表已存在”异常。尝试升级pandas到最新稳定版：

pip install --upgrade pandas

4. 表结构与DataFrame不匹配（特殊情况） #

如果之前手动修改过table1的结构（比如增删列），可能导致pandas验证时触发异常（旧版pandas可能误报）。先确认表结构和DataFrame列是否一致：

cursor = condb.cursor()
cursor.execute("PRAGMA table_info(table1);")
table_cols = [col[1] for col in cursor.fetchall()]
print(f"表列名: {table_cols}")
print(f"DataFrame列名: {list(df.columns)}")

若不一致，要么修改DataFrame列匹配表结构，要么删除表后重新创建：

cursor.execute("DROP TABLE IF EXISTS table1;")
condb.commit()
df.to_sql('table1', condb, if_exists='append', index=False)

快速验证脚本 #

运行这段代码确认表的真实状态，能帮你快速定位问题：

cursor = condb.cursor()
# 检查表是否存在
cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='table1';")
exists = cursor.fetchone() is not None
print(f"table1 是否存在: {exists}")

# 如果存在，打印表结构
if exists:
    cursor.execute("PRAGMA table_info(table1);")
    print("table1 结构:", cursor.fetchall())

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