SQLAlchemy问题：CSV转字典后SQLite表未填充类字段

这种情况我之前踩过好几次坑，大概率是字段映射不匹配或者反射表的环节出了问题，咱们一步步来捋：

1. 先确认反射的表结构与CSV字典的键是否匹配 #

反射表之后，先把表的字段和CSV转字典后的键打印出来对比，这是最容易出问题的环节：

from sqlalchemy import MetaData, create_engine
import pandas as pd

# 初始化引擎和反射元数据
engine = create_engine('sqlite:///your_database.db')
metadata = MetaData()
metadata.reflect(bind=engine)

# 打印反射表的所有字段名
print("Measurement表字段:", [col.name for col in metadata.tables['measurement'].columns])
print("Station表字段:", [col.name for col in metadata.tables['station'].columns])

# 打印CSV转字典后的第一条数据的键
df = pd.read_csv('your_data.csv')
print("CSV字典的键:", df.to_dict('records')[0].keys())

重点看有没有拼写错误、大小写差异（比如表字段是station_id，CSV键是stationId），或者表头带空格（比如station_id）——这些都会导致字段无法映射，最终只有自增主键被赋值。

2. 检查插入数据的方式是否正确 #

反射得到的是Table对象，不是你之前声明的ORM模型类，不能直接像模型类那样实例化插入。正确的做法是用Core的insert()语句：

from sqlalchemy.orm import sessionmaker

Session = sessionmaker(bind=engine)
session = Session()

# 转成字典列表
records = df.to_dict('records')

# 用反射的表对象执行插入
for record in records:
    # 确保record的键和表字段完全对应
    stmt = metadata.tables['measurement'].insert().values(**record)
    session.execute(stmt)

# 务必提交事务
session.commit()

如果之前你用了metadata.tables['measurement'](**record)这种错误方式实例化，就会导致除了主键外的字段都没被赋值。

3. 清洗CSV数据，避免格式或空值问题 #

有时候Pandas读CSV会把字段识别成空值，或者字段带多余字符（比如温度字段是25.5°C），导致插入时无法匹配字段类型：

# 示例：去掉表头空格、清洗带单位的数值字段
df.columns = df.columns.str.strip()  # 去掉表头的前后空格
df['temperature'] = df['temperature'].str.replace('°C', '').astype(float)  # 转换温度字段为数值类型

4. 确认反射表是否完整加载了所有字段 #

偶尔会出现反射时漏加载字段的情况，你可以直接打印整张表的结构确认：

print(metadata.tables['measurement'])

如果输出里缺少你创建表时定义的字段，可能是反射时的参数问题，比如可以指定only=['measurement', 'station']来明确反射的表：

metadata.reflect(bind=engine, only=['measurement', 'station'])

我之前就是因为CSV表头多了个空格，导致字段映射失败，查了半天发现只有主键能正常插入，按上面的步骤排查基本能解决问题。

内容的提问来源于stack exchange，提问作者HP-Nunes