Swift Vapor：如何同时通过迁移移除数据库字段并从结构体中删除该字段

这个问题确实是ORM迁移中很常见的痛点——依赖实体键路径的迁移代码和实体结构体的修改完全绑定，导致流程繁琐又容易出错。这里有几个更优雅的解决方案：

1. 使用原始SQL编写迁移（最直接的方案） #

既然依赖Swift键路径会导致编译问题，那我们可以绕开ORM的字段映射，直接用原始SQL来执行字段删除操作。这样迁移代码完全独立于User结构体，不管结构体有没有name字段，迁移都能正常运行。

示例代码：

static func prepare(on conn: PostgreSQLConnection) -> EventLoopFuture<Void> {
    // 注意表名要和你的User模型对应的数据库表名一致，通常是小写复数形式
    return conn.raw("ALTER TABLE users DROP COLUMN name;").run()
}

// 如果需要支持回滚，可以添加revert方法
static func revert(on conn: PostgreSQLConnection) -> EventLoopFuture<Void> {
    return conn.raw("ALTER TABLE users ADD COLUMN name VARCHAR;").run()
}

这种方式的好处是简单直接，不需要对现有User结构体做任何临时保留，你可以直接删掉name字段，再运行迁移即可。

2. 定义迁移专用的临时实体 #

如果不想写原始SQL，也可以在迁移文件内部定义一个临时的User结构体，专门用于迁移操作。这个临时结构体包含需要操作的name字段，和主代码里的User结构体完全解耦。

示例代码：

// 迁移专用的临时模型，只在这个迁移文件里生效
private struct MigrationUser: PostgreSQLModel {
    var id: Int?
    var name: String?
    // 复制原User结构体的其他所有字段，保证和数据库表结构匹配
    var email: String
    // ... 其他字段
}

struct RemoveUserNameMigration: Migration {
    static func prepare(on conn: PostgreSQLConnection) -> EventLoopFuture<Void> {
        return Database.update(MigrationUser.self, on: conn) { builder in
            builder.deleteField(for: \.name)
        }
    }

    static func revert(on conn: PostgreSQLConnection) -> EventLoopFuture<Void> {
        return Database.update(MigrationUser.self, on: conn) { builder in
            builder.field(for: \.name)
        }
    }
}

这样你可以直接修改主代码里的User结构体，删掉name字段，迁移代码因为用的是自己的MigrationUser，完全不会有编译问题。迁移完成后，这个临时结构体可以保留在文件里，或者直接删除都不影响。

3. 生产环境的分阶段部署（兼容老版本） #

如果是在生产环境，需要考虑正在运行的服务兼容性（比如老版本服务还在使用name字段），可以采用分阶段的方式：

• 第一阶段：保留User结构体的name字段，部署包含删除字段迁移的代码，运行迁移完成字段删除。
• 第二阶段：部署已经移除name字段的代码，同时可以清理掉对应的迁移代码（或者保留，因为迁移已经标记为执行完成，不会重复运行）。
  这个方案虽然流程多一点，但能保证服务的无缝升级，避免出现运行时错误。

总的来说，前两种方案都能很好地解决你遇到的编译绑定问题，推荐优先尝试原始SQL方案，高效又省心。

内容的提问来源于stack exchange，提问作者LinusG.