应使用 id = models.UUIDField(primary_key=True, default=uuid4, editable=False) 替换默认 AutoField，避免仅设 default=uuid4 导致隐式自增 id；注意数据库存储差异（PostgreSQL 原生支持，MySQL 推荐 BinaryUUIDField）、外键一致性、路由校验（）及迁移时的生态兼容性问题。
用 UUIDField 替换默认 AutoField 主键
直接在模型里把 id 字段声明为 UUIDField，并设 primary_key=True，Django 就不会再生成自增 ID。注意必须显式定义字段名（比如叫 id），不能只靠 default=uuid4 —— 否则 Django 仍会悄悄加一个隐式 AutoField。
常见错误是只写：
class MyModel(models.Model):<br> uuid = models.UUIDField(default=uuid4)
结果数据库里既有
id（自增）又有 uuid（非主键），完全没达到防遍历目的。
- 正确写法：
id = models.UUIDField(primary_key=True, default=uuid4, editable=False) -
editable=False防止 admin 或表单意外改写主键 - 别用
uuid1()—— 时间戳部分可被反推，暴露创建顺序 - 迁移前确认已有数据的处理策略：新表无历史数据可直接迁移；有存量数据需先加字段、填充、再删旧
id，操作复杂且需停写
PostgreSQL 和 MySQL 对 UUIDField 的索引与性能差异
主键类型切换后，查询性能不只看“是否 UUID”，更取决于数据库怎么存、怎么索引。PostgreSQL 原生支持 uuid 类型，B-tree 索引效率接近整数；MySQL 默认把 UUIDField 存成 char(32)，索引体积大、比较慢，还容易产生页分裂。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
- MySQL 用户强烈建议用
BinaryUUIDField（Django 4.2+）或手动转BINARY(16)存储，配合uuid_to_bin()函数写入 - PostgreSQL 可直接用原生
uuid类型，无需额外转换 - 无论哪种数据库，
UUIDField主键的插入性能都略低于自增 ID —— 因为无法预测下个值，B-tree 插入位置随机 - 外键关联时，所有引用该主键的字段也得统一用
UUIDField，否则类型不匹配报错
API 返回和前端传参时怎么安全透出 UUIDField 主键
URL 路由、API 响应、前端请求参数里出现 UUID 是常态，但容易忽略格式校验和大小写问题。Django 默认序列化 UUID 为小写带连字符格式（如 "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8"），但用户可能手输大写、漏连字符甚至粘连字符串，后端不拦截就会 404 或查到错误记录。
- 路由中用
path('<pk>/', ...)</pk>自动校验格式，比<pk></pk>安全得多 - 手动解析时务必用
uuid.UUID()包裹，捕获ValueError，别用正则粗筛 - 前端传参若拼接 URL，确保调用
.asHex或.toString()生成标准格式，避免 JS 的Math.random().toString(36)类伪 UUID 混入 - 日志里打印 UUID 时加
repr()或固定格式，防止连字符被日志系统截断
迁移已有自增 ID 表到 UUIDField 主键的实际卡点
这不是改个字段再跑 makemigrations 就完事的事。核心难点在于外键约束、第三方依赖（如 django-contrib-comments）、以及 Django 内部对 pk 的假设 —— 很多地方硬编码了 int 类型判断。
- 第三方 app 若依赖
AutoField（比如某些审计日志插件），大概率直接报AttributeError: 'UUID' object has no attribute 'bit_length' - 数据库层面，PostgreSQL 允许主键类型变更（
ALTER COLUMN ... TYPE uuid USING ...），MySQL 则必须新建列、复制数据、删旧列，过程需锁表 -
get_absolute_url()、reverse()等方法若硬编码args=[obj.id]，而obj.id变成UUID实例，可能触发TypeError: not all arguments converted during string formatting - 最稳妥路径：新增
uuid字段 → 批量填充 → 更新所有外键引用 → 删除旧id字段 → 把uuid改为主键。中间任何一步失败都得回滚，没法全自动
真正麻烦的不是 UUID 本身，而是整个生态对“主键 = 整数”这个隐含契约的深度依赖。改之前先 grep 全项目里的 .id、pk=、auto_now_add 相关逻辑，比读文档重要得多。
