Na vicat导入JSON失败？先别急，这四个坑你踩过吗？
数据迁移或批量导入时，Na vicat的JSON导入功能看似简单直接，实则暗藏玄机。操作不当，轻则字段错位，重则数据乱码甚至导入失败。根据大量的实践反馈，问题往往集中在以下四个核心环节。
Na vicat导入JSON失败主因有四：①JSON必须为array of objects格式；②字段名须严格大小写/符号匹配；③日期格式仅对字符串型日期生效且需与目标列类型对应；④中文乱码需同时确保JSON文件UTF-8无BOM、连接设utf8mb4、表字符集为utf8mb4。
Na vicat 导入 JSON 时字段映射不生效？先确认 JSON 结构类型
首先，得搞清楚Na vicat的“胃口”。它的JSON导入功能只认一种标准“餐盘”：扁平的 array of objects。说白了，就是一个JSON数组，里面每个元素都是键值对对象。至于单个的Object、嵌套数组或者结构复杂的混合体，它一概“消化不良”。如果你直接把一个像 {"name":"alice","age":30} 这样的单对象JSON拖进去，结果多半是报错，或者只给你导入一行意义不明的空数据。
- ✅ 正确格式长这样：
[{"id":1,"name":"Tom"},{"id":2,"name":"Jerry"}] - ❌ 这些格式都会碰壁：像
{"data":[{"id":1}]}或{"users":[{"id":1}]}这类带外层Key的结构——Na vicat可不会主动去解析里面的数组。 - 行动建议：导入前，不妨先用在线工具（比如 jsonlint.com）验明正身，确保它是合法的数组。如果不是，那就得请出Python或Node.js脚本，把需要的内层数组提取出来，另存为新文件再操作。
字段映射界面里找不到目标字段？检查表结构与 JSON key 是否严格匹配
到了“字段映射”这一步，界面左右分栏，左边展示的是从JSON第一行对象里提取出来的Key名，右边则是目标数据库表的列名。这里的匹配规则，堪称“强迫症级别”：大小写必须一致、空格一个不能多、特殊符号也得对得上。别以为MySQL表默认不区分大小写，Na vicat的映射逻辑就会跟着“随和”，它可是严格区分的。
- 举个例子，如果JSON里写着
"user_name"，而表里列名是username，它们不会自动牵手成功，必须你手动拖拽或者从下拉列表里重新选择。 - 更棘手的是空格。如果JSON Key里包含空格（比如
"full name"），Na vicat可能会把它转换成下划线full_name，也可能直接忽略。稳妥起见，最好在导入前用脚本预处理一下JSON，统一替换掉空格，比如执行.replace(/ /g, "_")。 - 当目标列是
TINYINT或ENUM这类特殊类型时，JSON里的对应值也得“门当户对”：必须是数字或枚举字面量（如"active"）。直接塞个true或者字符串"1"进去，除非字段本身允许隐式转换，否则很可能行不通。
“高级设置”里的“日期时间格式”填什么才有效？
这个输入框很容易让人误解。它只对JSON中字符串类型的日期字段起作用（例如 "created_at": "2024-03-15 14:22:08"），并且仅当目标列是 DATETIME 或 TIMESTAMP 类型时才生效。格式填错了，后果就是整列数据变成 NULL，或者导入过程直接中断。
- 记住这几个常用格式字符串（注意大小写和符号是固定的）：
yyyy-MM-dd HH:mm:ss、yyyy/MM/dd HH:mm:ss、MM/dd/yyyy HH:mm。 - 像
YYYY-MM-DDTHH:MM:SSZ这类标准的ISO 8601变体格式，Na vicat可能认不出来（除非你手动去掉中间的T和末尾的Z）。 - 这里有个关键陷阱：如果JSON里存的是毫秒时间戳（比如
1710512528000），那么在这个框里填任何格式都是徒劳的。正确的做法是，要么在准备JSON数据时，就提前把时间戳转成字符串日期；要么干脆放弃这个导入方式，改用SQL插入语句配合FROM_UNIXTIME()函数来处理。
导入后数据乱码或中文变问号？别只调 Na vicat 字符集
中文乱码是个老生常谈的问题，但原因往往比想象中复杂。把Na vicat界面上的字符集改成 UTF8，只是完成了第一步。真正决定数据能否“原汁原味”存储的，是下面这三个环节的字符集统一：Na vicat连接属性里的「字符集」、目标表的 CHARACTER SET、以及JSON文件本身的编码。三者缺一不可。
- 第一步，检查文件编码：用VS Code或Notepad++打开你的JSON文件，看看右下角显示的编码是不是纯正的
UTF-8。千万注意，UTF-8 with BOM格式反而会帮倒忙，可能导致第一条记录解析失败。 - 第二步，核对连接设置：在Na vicat连接属性的「高级」页签下，找到
MySQL Server charset选项，确保它被设置为utf8mb4（注意，是utf8mb4，不是旧的utf8）。 - 第三步，确认表结构：在数据库里执行一下
SHOW CREATE TABLE your_table;这条命令。仔细看看输出结果，确保表级默认字符集是DEFAULT CHARSET=utf8mb4，并且关键的文本字段也使用了utf8mb4_unicode_ci这类校对规则。
总结一下，字段映射看似配对了，但如果你的JSON文件带了BOM、连接字符集没设对、或者表还在用latin1编码——这三个地方只要漏掉一个，中文变问号的情况就难以避免。
