根本原因是数据库对ENUM字段的强校验：值必须严格匹配定义项，禁止空格、大小写偏差及不可见字符；MySQL尤其敏感，CSV中"active"与ENUM('Active','Inactive')不匹配即截断或置NULL。
CSV 导入时 ENUM 值报错 Column 'status' cannot be null 或 Data truncated for column 'type'
根本原因不是 csv 格式问题，而是数据库对 enum 字段的强校验：值必须严格匹配定义中的某一项，且不能有空格、大小写偏差、不可见字符（如 bom、尾部空格）。mysql 尤其敏感——哪怕 csv 里写的是 "active"，而 enum 定义是 enum('active', 'inactive')，就会被截断或置为 null。
- 导入前用文本编辑器打开 CSV，用「显示所有字符」功能确认无隐藏符号；导出时选 UTF-8 without BOM
- 用命令行快速检查唯一值：
cut -d, -f3 your.csv | sort -u（假设第 3 列是 ENUM 字段），比对结果和SHOW COLUMNS FROM table_name LIKE 'status'返回的Enum列值 - 如果 CSV 来自 Excel，务必禁用「自动转换数字为科学计数法」——它可能把
"001"变成1，而 ENUM 里存的是字符串
LOAD DATA INFILE 无法跳过非法 ENUM 值？
LOAD DATA INFILE 默认遇到非法 ENUM 值会报错中断，不支持「忽略该行」或「转为默认值」。想绕过，得在导入前做两件事：
- 临时把目标字段改成
VARCHAR（ALTER TABLE t MODIFY status VARCHAR(20)），导入完成后再用UPDATE清洗并改回ENUM - 或者用
mysqlimport加--ignore参数，但它只忽略主键/唯一键冲突，对 ENUM 无效；真正管用的是先建一张临时表，字段全设为TEXT，导入后再用INSERT ... SELECT+CASE映射合法值 - 别依赖
SET sql_mode = ''—— MySQL 8.0+ 已移除宽松模式，且即使旧版本开启，ENUM 校验仍强制生效
Python pandas read_csv + to_sql 写入 ENUM 字段失败
pandas 不识别 MySQL 的 ENUM 类型，to_sql 会把它当普通字符串处理，但底层 SQLAlchemy 插入时若类型不匹配，可能触发隐式转换失败，尤其当 ENUM 有空值或默认值时。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 显式指定 dtype：
dtype={'status': sqlalchemy.types.Enum('Active', 'Inactive', name='status_enum')}，注意枚举值必须和 DB 定义**完全一致**（包括顺序） - 更稳妥的做法是先用
df['status'].isin(['Active', 'Inactive'])过滤掉非法值，再插入；否则to_sql可能静默写入 NULL 或触发IntegrityError - 避免用
if_exists='replace'—— 它会删表重建，新表 ENUM 定义可能丢失或顺序错乱，导致后续插入失败
PostgreSQL 的 ENUM 和 MySQL 处理逻辑完全不同
PostgreSQL 的 ENUM 是独立类型，需先 CREATE TYPE，且 CSV 导入时（如 psql -c "\copy..."）要求值**字面量完全匹配**，不区分大小写的配置（citext）对 ENUM 无效。
- 导入前执行
SELECT enumlabel FROM pg_enum WHERE enumtypid = 'your_enum_type'::regtype获取真实值列表 - PostgreSQL 不允许直接 INSERT 不存在的 ENUM 值，也不会自动转成 NULL；错误信息通常是
invalid input value for enum - 如果必须兼容多种输入格式，建议放弃原生 ENUM，改用
TEXT+CHECK (status IN ('active', 'inactive'))，维护成本更低，也方便后期扩展
最麻烦的不是怎么导，而是发现拼写差异的时间点——往往等线上查不到数据才意识到 CSV 里写的是 "pendding" 而不是 "pending"。建议把枚举值列表固化成一个 JSON 文件，在 ETL 脚本里做校验，而不是靠人眼比对。
