Access数据库Excel数据导入失败：INSERT语句语法错误求助

问题背景 #

使用Python的pandas+pyodbc模块将Excel数据导入Access多表，已完成列映射配置，但执行INSERT语句时触发ProgrammingError，提示INSERT INTO语句存在语法错误：

INSERT INTO table_name (...) VALUES (...)
ProgrammingError: ('42000', '[42000] [Microsoft][ODBC-Treiber für Microsoft Access] Syntaxfehler in der INSERT INTO-Anweisung. (-3502) (SQLExecDirectW)')

排查与解决步骤 #

1. 检查字段名是否包含保留字或特殊字符 #

Access内置大量保留字（如Date、Name、Value、Order等），若字段名与保留字重名，或字段名包含空格、-、#等特殊字符，必须用方括号[]包裹字段名。
示例：

• 错误写法：INSERT INTO orders (Order Date, Name) VALUES (...)
• 正确写法：INSERT INTO orders ([Order Date], [Name]) VALUES (...)

2. 确认字段数量与值数量完全匹配 #

仔细核对INSERT INTO后的字段列表，与VALUES后的参数列表的数量、顺序是否完全对应，多列或少列都会触发语法错误。

3. 处理值的转义与类型匹配 #

• 字符串值含单引号时，需将单个单引号替换为两个单引号（'→''），避免SQL语句截断，比如O'Neil需写成O''Neil。
• 日期类型值必须用#包裹，格式为#YYYY-MM-DD#，而非普通字符串格式。
• 数值类型值不要加引号，确保与Access表字段类型匹配。

4. 改用参数化查询替代SQL字符串拼接 #

直接拼接SQL字符串极易引发语法错误和安全问题，使用pyodbc的参数化查询可彻底避免这类问题，同时自动处理类型转义。
示例代码：

import pyodbc
import pandas as pd

# 建立Access连接
conn_str = r'DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=./your_database.accdb;'
conn = pyodbc.connect(conn_str)
cursor = conn.cursor()

# 读取Excel数据
df = pd.read_excel('./data_source.xlsx')

# 定义参数化INSERT语句（字段名用方括号包裹）
insert_sql = """
INSERT INTO target_table ([id], [user_name], [register_date])
VALUES (?, ?, ?)
"""

# 遍历数据执行插入
for _, row in df.iterrows():
    # 处理日期空值与格式
    reg_date = row['register_date'].strftime('%Y-%m-%d') if pd.notna(row['register_date']) else None
    # 传入参数执行
    cursor.execute(insert_sql, (row['id'], row['user_name'], reg_date))

# 提交事务并关闭连接
conn.commit()
cursor.close()
conn.close()

5. 验证Access表的约束条件 #

Access的错误提示有时不够精准，若上述步骤无效，检查目标表是否存在以下约束：

• 主键字段是否重复
• 非空字段是否传入空值
• 外键字段是否关联了不存在的值

6. 打印完整SQL语句手动测试 #

若仍无法定位问题，将生成的完整INSERT语句打印出来，复制到Access的查询设计视图中运行，Access会给出更具体的错误位置提示：

for _, row in df.iterrows():
    # 拼接语句并打印
    sql = f"INSERT INTO target_table ([id], [user_name]) VALUES ('{row['id']}', '{row['user_name']}')"
    print(sql)
    cursor.execute(sql)

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