Swift Vapor中如何基于Siblings关系筛选指定分支的客户？

Vapor的@Siblings多对多关联无法直接通过~~（包含于）操作符在Customer查询中过滤关联分支，因为ORM无法将这种集合匹配逻辑直接转化为对应的SQL关联查询。以下是两种高效的实现方案：

方案1：直接从Customer查询（推荐） #

通过关联中间表BranchCustomer，用关联查询的方式筛选属于指定分支的客户，数据库层面自动去重，性能最优：

// 先提取有效分支ID
let targetBranchIds = authorizedUser.branches.compactMap { $0.id }

// 构建Customer查询
let filteredCustomers = try await Customer
    .query(on: request.db)
    // 关联中间表BranchCustomer
    .join(BranchCustomer.self, on: \Customer.$id == \BranchCustomer.$customer.$id)
    // 用IN查询匹配分支ID数组，替代手动构建OR组
    .filter(\BranchCustomer.$branch.$id ~~ targetBranchIds)
    // 按姓名排序
    .sort(\.$firstName)
    // 可选：如果需要加载客户关联的所有分支
    .with(\.$branches)
    .all()

优势： #

• 数据库层面直接返回唯一的Customer记录，无需手动去重
• 使用IN查询替代多个OR条件，SQL执行效率更高
• 代码简洁，逻辑清晰

方案2：从中间表查询（适合需获取中间表数据的场景） #

如果需要同时获取BranchCustomer的关联数据，可以优化你原本的写法，用IN查询替代循环构建OR组，最后手动去重：

let targetBranchIds = authorizedUser.branches.compactMap { $0.id }

// 查询关联的中间表记录
let branchCustomerPivots = try await BranchCustomer
    .query(on: request.db)
    .filter(\.$branch.$id ~~ targetBranchIds)
    // 关联并加载Customer数据
    .with(\.$customer)
    .all()

// 提取Customer并去重（避免同一客户属于多个指定分支时重复）
let filteredCustomers = Array(Set(branchCustomerPivots.map { $0.customer }))
    .sorted { $0.firstName < $1.firstName }

注意： #

• 因为同一客户可能关联多个目标分支，中间表会返回多条记录，所以需要用Set去重
• 若不需要中间表数据，优先选择方案1

为什么最初的写法无法编译？ #

\.$branches ~~ [branch1, branch2]这种写法试图直接过滤Customer的branches集合，但@Siblings是延迟加载的多对多关联，Vapor的QueryBuilder无法将这种集合匹配逻辑转化为SQL语句——SQL中必须通过关联中间表才能实现多对多的过滤，而非直接在customer表上操作。

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