4. 数据解析与字段映射问题：字段类型不匹配、大小写敏感与空值处理

好，咱们接着聊。数据解析和字段映射这块，说白了就是「把源数据塞进目标表」的过程。听起来简单？我刚开始做的时候也这么想，结果被坑得够呛。今天我把最常见的三个坑——字段类型不匹配、字段名大小写敏感、空值处理不当——掰开揉碎了讲清楚。

4.1 字段类型不匹配——字符串截断只是冰山一角

先说说类型不匹配。这是最频繁出现的问题，没有之一。

典型场景：源数据里某个字段是 VARCHAR(255)，目标表里定义的是 VARCHAR(50)。你导入的时候，超过 50 个字符的内容就被截断了。嗯，数据丢了，但程序不报错——这才是最可怕的。

我在项目中遇到过类似情况：一个地址字段，源数据里最长有 200 多个字符，目标表只设了 100。结果导入后，某条记录的「XX省XX市XX区XX路XX号XX小区XX栋XX单元XX室」变成了「XX省XX市XX区XX路XX号XX小区XX栋XX单元」——少了门牌号。用户投诉说快递收不到，查了半天才发现是字段截断。

其他常见类型不匹配：

• 数值精度丢失：源数据是 DECIMAL(10,4)，目标表是 DECIMAL(8,2)。小数点后两位以外的数据被四舍五入或直接截断。
• 日期格式不一致：源数据是 '2024-01-15 14:30:00'，目标表字段是 DATE 类型。时间部分被丢弃，或者直接报错。
• 布尔值映射：源数据用 0/1 表示，目标表用 'Y'/'N' 或 true/false。不转换就报错。

4.2 字段名大小写敏感——Windows 和 Linux 的隐形差异

这个问题，说白了就是「你的数据库在哪个系统上跑」。

在 Windows 上，MySQL 默认对表名和字段名不区分大小写。但在 Linux 上，默认是区分大小写的。你想想看，在 Windows 上开发好的脚本，部署到 Linux 服务器上，突然就报错了——字段名 'UserName' 和 'username' 被认为是两个不同的字段。

我曾经在项目上线前夜遇到这个问题。开发环境是 Windows，测试环境也是 Windows，一切正常。结果部署到生产环境的 Linux 服务器上，导入脚本直接崩了。查了三个小时，最后发现是字段名大小写的问题。嗯，从那以后，我所有脚本里的字段名都统一用小写加下划线。

代码示例：字段名映射处理

-- 不推荐：大小写混用
SELECT UserName, CreateTime FROM UserInfo;

-- 推荐：统一小写
SELECT user_name, create_time FROM user_info;

-- 或者使用别名映射
SELECT UserName AS user_name, CreateTime AS create_time FROM UserInfo;

4.3 空值处理不当——NULL 和空字符串不是一回事

这个问题，我敢说 90% 的新手都踩过坑。NULL 和空字符串（''）在数据库里是完全不同的概念，但在很多人的认知里「反正都是没数据嘛」。

区别在哪？

特性	NULL	空字符串 ''
含义	未知、不存在	有值，但值为空
长度	无	0
比较运算	IS NULL / IS NOT NULL	= '' 或 <> ''
聚合函数	COUNT 不统计，SUM/AVG 忽略	COUNT 统计，SUM/AVG 参与计算
字符串拼接	结果为 NULL	正常拼接

我在项目中遇到过这样的问题：导入客户数据时，电话号码字段有的是 NULL，有的是空字符串。业务系统要求「电话号码为空时发送短信提醒」，结果 NULL 的记录被跳过了，空字符串的记录却触发了短信——因为 NULL 和 '' 在代码里的判断逻辑不一样。

代码示例：空值统一处理

-- 将空字符串转为 NULL
UPDATE target_table 
SET phone = NULLIF(phone, '');

-- 将 NULL 转为默认值
UPDATE target_table 
SET status = COALESCE(status, '未知');

-- 导入时直接处理
INSERT INTO target_table (name, phone, status)
SELECT 
    name,
    NULLIF(phone, '') AS phone,
    COALESCE(status, '正常') AS status
FROM source_table;

4.4 知识体系总览

下面这张图，我把数据解析与字段映射的核心逻辑画出来了。你可以把它当作排查问题的路线图。

4.5 实战排查清单

最后，我给你一个排查清单。下次遇到数据导入问题，按这个顺序查一遍，基本能定位 90% 的问题。

1. 检查字段类型：源字段和目标字段的类型、长度、精度是否一致？
2. 检查字段名：大小写是否匹配？有没有多余的空格或特殊字符？
3. 检查空值：源数据中的 NULL 和空字符串是否被正确处理？
4. 检查编码：源数据和目标数据库的字符集是否一致？
5. 检查约束：目标表是否有 NOT NULL、UNIQUE、FOREIGN KEY 等约束？

好了，数据解析与字段映射的问题就讲到这里。记住一句话：导入前多花十分钟做校验，导入后少花十小时做排查。