Vapor/Fluent中兄弟关系必填字段为Nil引发致命错误

我在获取ExerciseBase实体时尝试预加载其兄弟关系allowedEquipments，代码如下：

let all = try await ExerciseBase
    .query(on: req.db)
    .with(\.$allowedEquipments) // 此处触发错误
    .all()

运行时出现致命错误："field is not initialized or fetched"。该字段已声明为必填非可选类型，按逻辑保存数据时若为空应报错，且数据库中的数据条目是正确的，因此问题应出在关系加载环节。

我已检查数据、数据库配置、Docker环境及查询语句，仍未定位问题，寻求排查思路。

相关代码 #

迁移代码 #

struct CreateExerciseBaseEquipmentPivot: Migration {
    func prepare(on database: Database) -> EventLoopFuture<Void> {
        database.schema(ExerciseBaseEquipment.schema)
            .id()
            .field("exercise_base_id",
                   .uuid,
                   .required,
                   .references(ExerciseBase.schema, "id", onDelete: .cascade)
            )
            .field("equipment_id",
                   .uuid,
                   .required,
                   .references(Equipment.schema, "id", onDelete: .cascade)
            )
            .unique(on: "exercise_base_id", "equipment_id")
            .create()
    }

    func revert(on database: Database) -> EventLoopFuture<Void> {
        database.schema(ExerciseBaseEquipment.schema)
            .delete()
    }
}

中间模型代码 #

final class ExerciseBaseEquipment: Model {
    static let schema = "exercise_base+equipments"

    @ID(key: .id)                       var id: UUID?
    @Parent(key: "exercise_base_id")    var exerciseBase: ExerciseBase
    @Parent(key: "equipment_id")        var equipment: Equipment

    init() {}

    init(id: UUID? = nil,
         exerciseBase: ExerciseBase,
         equipment: Equipment
    ) throws {
        self.id = id
        self.$equipment.id = try equipment.requireID()
        self.$exerciseBase.id = try exerciseBase.requireID()
    }
}

ExerciseBase中的兄弟关系定义 #

@Siblings(
    through: ExerciseBaseEquipment.self,
    from: \.$exerciseBase,
    to: \.$equipment
) var allowedEquipments: [Equipment]

排查思路与修复建议 #

• 核对关系映射方向：确认@Siblings的from和to参数是否正确绑定中间模型的属性。from需指向中间模型关联当前实体（ExerciseBase）的属性，to指向关联目标实体（Equipment）的属性，当前代码看起来符合要求，但可再次核对。
• 替换表名特殊字符：中间模型的schema使用了+字符，部分数据库对特殊字符的解析可能存在问题。建议将表名改为下划线分隔的exercise_base_equipments，同步修改迁移代码中的表名，重新运行迁移。
• 验证中间表关联数据：单独查询中间表ExerciseBaseEquipment，检查是否能正确加载关联的ExerciseBase和Equipment，确认数据关联关系无误：

  let pivots = try await ExerciseBaseEquipment.query(on: req.db).all()
  print(pivots)
  

• 重新执行迁移：删除数据库中的_fluent_migrations表，执行回滚后重新迁移，确保表结构与模型定义完全一致：

  vapor run migrate --revert
  vapor run migrate
  

• 检查Fluent版本：确认Vapor与Fluent版本匹配，是否存在已知的关系预加载bug，尝试升级到最新稳定版本。
• 确认实体ID加载：检查ExerciseBase的@ID字段定义是否正确，确保查询时实体ID被正常获取，避免因ID未加载导致关系绑定失败。

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