Objection.js eager查询报missing FROM-clause及modifyEager关联字段为空问题

主查询报missing FROM-clause entry for table的原因 #

Objection.js的默认eager加载采用主查询与关联查询分离执行的逻辑：主查询仅针对GiftPayments表执行取数，后续才单独发起关联查询加载gift、detail、status数据，关联表不会被加入主查询的FROM/JOIN子句。
主查询的where条件中直接写gift.status.name时，Postgres在执行主查询阶段无法识别gift、status表的存在，自然抛出缺失FROM子句的错误。

修改后关联status字段为null的原因 #

使用modifyEager时存在两处逻辑偏差：

• 过滤路径错位：modifyEager('gift', builder => builder.where('name', '=', 'Closed'))的过滤条件是作用于gift表自身的，逻辑为筛选name等于Closed的gift记录，完全未触达gift关联的status表
• 作用域认知偏差：modifyEager仅控制需加载哪些关联数据，不会过滤主表GiftPayments的记录。只要主表存在对应支付记录，哪怕关联数据被过滤后无匹配结果，整条支付记录仍会返回，仅对应的gift关联字段被赋值为null，这就是status字段为null的直接原因。

场景1：仅返回「关联gift状态为Closed的GiftPayments记录」 #

该场景需要在主查询阶段将关联表JOIN进查询逻辑，使用joinRelated即可完全规避表名识别错误的问题：

const payments = await GiftPayments.query()
  // 主查询阶段直接JOIN关联的gift、status表，Postgres可正确识别表引用
  .joinRelated('gift.status')
  // 过滤条件直接作用于JOIN后的status表
  .where('status.name', 'Closed')
  // 加载所需关联详情数据
  .eager('gift.[detail, status]')
  .orderBy('gift.id');

该方案在数据库层面完成JOIN与过滤，仅返回符合关联状态要求的支付记录，不会出现关联字段为空的不匹配结果。

场景2：无需过滤主表，仅加载符合状态要求的关联gift #

该场景需将modifyEager的作用路径精确到待筛选的关联层级，避免过滤逻辑作用错表：

const payments = await GiftPayments.query()
  .eager('gift.[detail, status]')
  // 明确指定过滤逻辑作用于gift下关联的status表，而非gift表本身
  .modifyEager('gift.status', builder => {
    builder.where('name', 'Closed');
  })
  .orderBy('gift.id');

注意：该方案不会过滤主表GiftPayments的记录，所有支付记录都会返回，仅当关联gift状态为Closed时才会加载对应的gift字段，否则gift字段为null。

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