GRDB Swift 如何通过数据迁移修改列类型将UUID转为String？

你构思的实现逻辑完全正确，这是SQLite场景下修改列类型的标准、无风险方案。由于SQLite的ALTER TABLE语法存在较多限制，不支持直接修改已有列的存储类型，因此通过新建表迁移数据的方式是官方推荐的最优解，不存在隐性坑点。

• 无需逐行遍历迁移数据，直接使用INSERT INTO ... SELECT批量语句完成数据迁移，相比逐行读写性能提升数倍，尤其适合数据量较大的表
• 迁移前记得把旧表的所有约束、索引、外键配置都同步到新表，避免迁移后功能异常
• 增加数据一致性校验步骤，对比新旧表的行数、核心字段的校验值，避免数据丢失
• 若需要保留标准带横杠的UUID字符串格式，可以在SELECT阶段通过SQL字符串函数直接拼接，无需业务层额外处理

// 自定义迁移异常
enum MigrationError: Error {
    case dataCountMismatch
}

registerMigration("UUIDMigrationToString") { db in
    // 1. 创建新表，列结构、约束、索引和旧表完全一致，仅将原UUID列改为text类型
    try db.create(table: "new_target_table") { table in
        table.autoIncrementedPrimaryKey("id")
        table.column("someIdStuff", .text).notNull()
        // 其他列和旧表保持完全一致
        table.column("other_column1", .text)
        table.column("other_column2", .integer)
    }
    
    // 2. 批量迁移数据，二进制存储的UUID通过HEX函数转成十六进制字符串
    // 如果需要带横杠的标准UUID格式，可以用substr拼接字符串
    try db.execute(
        sql: """
        INSERT INTO new_target_table (id, someIdStuff, other_column1, other_column2) 
        SELECT id, 
        substr(hex(someIdStuff),1,8) || '-' || substr(hex(someIdStuff),9,4) || '-' || substr(hex(someIdStuff),13,4) || '-' || substr(hex(someIdStuff),17,4) || '-' || substr(hex(someIdStuff),21),
        other_column1, other_column2 
        FROM target_table
        """
    )
    
    // 3. 校验数据一致性
    let oldCount = try Int.fetchOne(db, sql: "SELECT COUNT(*) FROM target_table")!
    let newCount = try Int.fetchOne(db, sql: "SELECT COUNT(*) FROM new_target_table")!
    guard oldCount == newCount else {
        throw MigrationError.dataCountMismatch
    }
    
    // 4. 删除旧表、重命名新表
    try db.drop(table: "target_table")
    try db.rename(table: "new_target_table", to: "target_table")
}

• 迁移完成后需要将对应ORM模型的UUID类型属性修改为String类型，避免运行时ORM自动将存储的字符串转回UUID对象，还是无法直接在数据库浏览工具中查看
• 上线前先在测试环境验证存量数据迁移后的格式符合预期，再发布到生产环境

内容的提问来源于stack exchange，提问作者Glenn Posadas