Navicat字段类型映射不透明且易错,需手动指定映射、校验时区与约束差异,并用脚本或开源工具替代以保障可复现性。
Navicat 导出/同步时字段类型自动转换错乱
navicat 本身不提供显式的“异构表字段类型映射”配置界面,所谓“映射”实际发生在数据迁移、结构同步或导出为 sql 的过程中,由其内置的类型转换规则引擎驱动。它会根据源库和目标库的方言(如 mysql → postgresql)硬编码一套默认映射表,但这个表不透明、不可编辑,且容易在边界类型上出错——比如把 tinyint(1) 当作布尔转成 boolean,而目标库其实没布尔类型;或把 json 直接塞进 text,丢掉校验能力。
实操建议:
- 迁移前先用
SELECT COLUMN_NAME, DATA_TYPE, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT FROM INFORMATION_SCHEMA.COLUMNS分别查清源表和目标表的实际类型定义,尤其注意COLUMN_TYPE(含长度、符号、精度等细节) - 禁用 Navicat 的“自动识别类型”选项:在数据传输向导中,点击“高级”→取消勾选
Auto-detect data types - 手动指定列映射:在字段映射步骤中,对每一列点开下拉菜单,不要依赖默认值,逐个选目标类型——例如源是
DECIMAL(10,2),目标 PostgreSQL 应选NUMERIC(10,2),而非笼统的NUMERIC - 若目标库类型不支持(如 MySQL 的
ENUM到 SQLite),必须提前建好兼容字段(如用VARCHAR+ CHECK 约束),并在 Navicat 映射时强制指定,否则同步会静默失败或截断
跨数据库同步时 TIMESTAMP 和时区处理失准
TIMESTAMP 是最常翻车的类型之一。MySQL 的 TIMESTAMP 默认带时区隐式转换(存 UTC,读本地时区),而 PostgreSQL 的 TIMESTAMP WITH TIME ZONE 行为不同,SQLite 根本没有原生时区支持。Navicat 在同步时若未显式干预,会直接按字符串拼接或二进制拷贝,导致时间偏移几小时甚至日期错位。
实操建议:
- 统一源库连接参数:MySQL 连接串里加上
?serverTimezone=UTC,PostgreSQL 连接里确保timezone='UTC'已设 - 在 Navicat 数据传输设置中,勾选
Convert timestamp to UTC(如有),否则手动在“SQL 预处理”里加转换,例如源 MySQL 中用CONVERT_TZ(col, @@session.time_zone, '+00:00') - 目标字段类型优先选带时区的:MySQL → PostgreSQL 同步时,源
TIMESTAMP应映射到TIMESTAMP WITH TIME ZONE,而非TIMESTAMP WITHOUT TIME ZONE - 避免用 Navicat 导出“创建表语句”来建目标结构——它的 DDL 生成器常忽略时区修饰符,应手写或用目标库原生
pg_dump --schema-only类工具生成基线
Navicat 结构同步忽略 NOT NULL / DEFAULT 差异
字段类型只是表结构一致性的一小部分。Navicat 的“结构同步”功能默认只比对字段名、类型、长度,对 NOT NULL、DEFAULT、CHECK、COMMENT 等约束默认不参与差异检测,除非你主动在同步设置里打开对应开关。结果就是:开发库加了 NOT NULL,测试库没同步过去,后续 INSERT NULL 不报错,数据质量隐患埋得深。
实操建议:
- 进入结构同步向导后,点“选项”→在
Compare options标签页中,务必勾选:Compare NOT NULL constraints、Compare default values、Compare comments - MySQL 源的
DEFAULT CURRENT_TIMESTAMP在同步到 PostgreSQL 时,Navicat 可能转成DEFAULT NOW(),但 PostgreSQL 要求显式写DEFAULT NOW()::TIMESTAMP WITH TIME ZONE才匹配行为,需手动修正生成的 SQL - 如果目标库已有数据,同步前检查
DEFAULT是否会导致现有行违反新约束(如给非空字段加NOT NULL且无默认值),Navicat 不会预警,得自己跑SELECT COUNT(*) FROM tbl WHERE col IS NULL
自动化脚本里无法复用 Navicat 的映射逻辑
Navicat 的类型映射是 GUI 内部状态,不导出、不持久化、不暴露 API。你在一个项目里调好了一套 MySQL → PostgreSQL 的映射,换个项目重装 Navicat 或换台电脑,一切归零。更麻烦的是,CI/CD 流水线里没法调用它——没有命令行入口,也没有配置文件可 commit。
实操建议:
- 把最终确认的映射关系固化为 SQL 脚本:用
CREATE TABLE ... AS SELECT或ALTER TABLE ... ALTER COLUMN ... TYPE显式声明每一步转换,而不是依赖 Navicat 一键同步 - 用开源工具替代关键环节:例如用
pgloader做 MySQL → PostgreSQL 迁移,它的映射规则可写在配置文件里,支持正则匹配字段名、条件判断类型,还能加自定义转换函数 - 在团队 Wiki 或 README 里维护一份《跨库类型对照速查表》,注明每个组合(如 MySQL
YEAR→ PostgreSQLSMALLINT)及理由,比依赖 Navicat 的黑盒逻辑更可靠
真正难的不是让 Navicat “做对”,而是它根本不会告诉你它“做错了什么”。所有映射决策都该有日志、有备份、有回滚路径——尤其是生产环境同步前,先在空库上跑一次,再用 diff 对比生成的 DDL,比盯着 Navicat 的进度条有用得多。










