navicat 原生不支持嵌套字段映射，仅识别扁平 json 结构；遇 {"data":[{"id":1}]} 或 {"user":{"name":"alice"}} 等嵌套格式会导入失败或为空；必须用脚本（如 pandas.json_normalize）展平为一级 key 才能正常导入。
navicat 原生不支持嵌套字段映射——它只认扁平的 [{"key":"value"}] 结构，遇到 {"data":[{"id":1}]} 或 {"user":{"name":"alice"}} 这类嵌套 json，直接导入会失败或只导入空行。
为什么 Navicat 无法识别嵌套 JSON？
Navicat 的 JSON 导入器底层按“数组第一层对象的 key”提取字段名。它不会递归解析 user.name、address.city 这样的路径，也不会展开 items 数组生成多行。所有嵌套层级都被当作字符串或直接忽略。
常见错误现象：
- 导入后所有字段为
NULL或仅首行有数据 - 向导中左侧字段列表为空，或只显示
data、user这样的外层 key - 报错
Invalid JSON format或静默跳过大部分内容
必须先 flatten 嵌套结构（Python 脚本示例）
用脚本把嵌套字段展平成一级 key，是唯一可靠的做法。比如将 {"user":{"name":"alice","age":30}} 转成 {"user_name":"alice","user_age":30}。
实操建议：
- 用 Python 的
json+pandas.json_normalize最省事：import pandas as pd import json <p>with open('nested.json') as f: data = json.load(f)</p><h1>假设原始数据在外层 key 'users' 下</h1><p>df = pd.json<em>normalize(data['users'], sep='</em>') df.to_json('flattened.json', orient='records', indent=2)</p> - 如果不用 pandas，手写递归展平函数时注意：避免 key 冲突（如
{"a":{"b":1},"a_b":2}展平后会覆盖），建议加前缀或校验 - 对含数组的字段（如
"tags":["x","y"]），json_normalize默认转成字符串["x","y"]；如需拆成多行，得额外 explode 处理
字段映射时大小写与特殊字符必须严格一致
Navicat 字段映射是精确字符串匹配，不是模糊或 case-insensitive 匹配。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
容易踩的坑：
- JSON 里是
created_at，表里列名是createdAt→ 不会自动关联，必须手动拖拽 - JSON 含空格或中文键名（如
"用户姓名"）→ Navicat 可能转成用户姓名或丢弃，导入前统一替换成下划线：item.keys()遍历替换.replace(' ', '_').replace('用户姓名', 'user_name') - MySQL 表列名含反引号（
`order`）→ Navicat 映射界面不显示反引号，右侧列表只显示order，但映射时仍要确保名称完全一致
导入前务必验证 JSON 合法性与结构
别跳过这步。一个看似正常的 JSON 文件，可能因 BOM、尾部逗号、单引号或 Unicode 编码问题导致 Navicat 解析失败。
快速验证方法：
- 用
jq检查格式和结构：jq 'length,.[0]' input.json看是否输出数组长度和首条记录 - 打开
jsonlint.com粘贴内容，确认无语法错误 - 在 Navicat 导入向导第二步点击「预览」——如果预览窗口空白或报错，说明 JSON 格式或结构不符合要求，别硬点下一步
- 若原始 JSON 是从 API 抓取的，注意响应头是否含
Content-Encoding: gzip；Navicat 不解压，需先用gunzip解压再导入
嵌套字段不是“映射不出来”，而是 Navicat 根本没设计这功能。所有所谓“支持嵌套”的说法，都建立在你提前把它打平的基础上。漏掉展平或验证，后面每一步都是徒劳。
