Django 跨数据库迁移实战指南：MySQL 至 PostgreSQL

password

查看人数

type

Post

status

Published

date

Feb 5, 2026 11:52

slug

974ee09a-b89d-4efb-89ec-95fce8cf7dcc

summary

源库导出 (MySQL) -> 2. 编码修复 -> 3. 目标库建表 (PG) -> 4. 数据导入 -> 5. 序列重置

在导出时，最容易遇到的问题是 Windows 环境下的 编码错误 (UTF-8)。

在 PowerShell 中强制 Python 使用 UTF-8 模式，防止中文乱码：

使用 -o 参数而非重定向符号 >，确保 Django 内部处理编码：

PostgreSQL（尤其是云服务如 Neon）强制要求 SSL 连接：

在导入数据前，目标库必须有表结构，但必须是空表：

migrate 命令会自动生成基础权限和类型数据，如果 data.json 里也包含这些，会导致主键冲突。必须排除：

注意：如果依然报错 UnicodeDecodeError，说明导出的文件编码仍有问题，需通过 VS Code 将 data.json 重新保存为 UTF-8 编码。

这是最容易被遗忘的一步。PostgreSQL 使用 SEQUENCE 管理自增 ID。手动导入 ID 后，计数器不会自动更新。

将上述命令生成的 SELECT setval(...) 语句全部复制，在数据库管理工具（DBeaver/Navicat/Neon Console）的 SQL 窗口执行。

如果不执行此步： 你在网页上新增任何数据都会报 Duplicate Key 错误。

报错信息	原因	解决方法
UnicodeDecodeError: 'utf-8' byte 0xb5...	Windows 默认编码不是 UTF-8	设置 $env:PYTHONUTF8 = 1 重新导出，或用 VS Code 转码
relation "auth_user" does not exist	目标库没建表	先执行 python manage.py migrate
database "xxx" does not exist	配置的 NAME 与云端不符	去 Neon 控制台确认 Database 名字（默认为 neondb）
SSL connection is insecure	缺少 SSL 配置	在 OPTIONS 中加入 'sslmode': 'require'
IntegrityError: (1, ...)	权限数据冲突	使用 --exclude contenttypes --exclude auth.Permission

执行完 loaddata 提示 Installed xxx object(s)。

执行完 sqlsequencereset 生成的 SQL 并在数据库中运行。

启动服务后，能在页面看到旧数据。

点击“新增”按钮，能成功创建一条新数据（证明序列修复成功）。

💡

有关使用上的问题，欢迎您在底部评论区留言，一起交流~