Django多数据库适配问题：SQL Server中UUIDField映射为char(32)

针对你的场景——需要在SQLite、SQL Server、PostgreSQL之间平滑切换，同时保证UUID字段的性能和兼容性，核心解决方案是让每个数据库使用原生的UUID类型，而非依赖Django默认的char(32)映射。

为什么SQL Server会映射成char(32)？ #

Django默认的UUIDField在SQL Server后端会将UUID转换为32位无连字符的字符串，存储为char(32)，但这并非最优选择：SQL Server有原生的uniqueidentifier类型（16字节），比char(32)（32字节）占用空间更小，且数据库对原生类型有索引、唯一性约束的性能优化；同时，PostgreSQL的原生uuid类型与uniqueidentifier逻辑一致，用原生类型能避免未来切换数据库时的类型适配问题。

实现跨数据库兼容的自定义UUID字段 #

创建一个自定义字段，根据不同数据库引擎返回对应的原生类型：

from django.db import models
import uuid

class CrossDBUUIDField(models.UUIDField):
    def db_type(self, connection):
        match connection.vendor:
            case 'mssql':
                return 'uniqueidentifier'
            case 'postgresql':
                return 'uuid'
            case 'sqlite':
                return 'char(36)'  # SQLite无原生UUID类型，存储标准带连字符的UUID格式
            case _:
                return super().db_type(connection)

然后在模型中替换默认的UUIDField：

user_guid = CrossDBUUIDField(
    default=uuid.uuid4,  
    editable=False,      
    unique=True,          
    null=False,          
    blank=False,         
    db_index=True        
)

这样做的优势 #

• 性能优化：SQL Server用uniqueidentifier（16字节）替代char(32)，减少存储空间，提升索引查询效率；PostgreSQL用原生uuid类型，充分利用数据库优化。
• 平滑迁移：未来切换到PostgreSQL时，无需修改字段定义，直接切换数据库配置即可。
• 兼容性一致：SQLite存储标准36位带连字符的UUID，保证数据格式与其他数据库兼容，避免转换问题。

如果已有char(32)字段的迁移方案 #

如果已经基于默认UUIDField生成了SQL Server的char(32)字段，需要通过迁移将其转换为uniqueidentifier：

1. 生成迁移文件，添加临时uniqueidentifier字段。
2. 编写数据迁移逻辑，将char(32)的无连字符UUID转换为标准带连字符格式（例如：xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx），存入临时字段。
3. 删除原char(32)字段，将临时字段重命名为原字段名，并添加unique、db_index等约束。

建议在开发阶段尽早调整，避免生产环境大规模数据迁移的复杂度。

内容的提问来源于stack exchange，提问作者Krzysztof Krysztofczyk