Hanami框架多对多Through关联查询异常：仅返回单条结果

问题描述 #

我在Hanami中使用了多对多关联，代码如下：

class OwnerRepository < Hanami::Repository
 
    associations do 
        has_one :avator
        has_many :oneships#It's for join table..
        has_many :avators,through: :oneships
    end


    def find_with_avator(id)
        aggregate(:avator).where(id: id).map_to(Owner).one
    end

    def find_with_avators(id)
        aggregate(:avators).where(id: id).map_to(Owner).one
        #This found one avator but should be found two???
    end

end

我创建了两个Owner，每个Owner通过oneships关联两个Avator，但调用find_with_avators方法查询时仅返回一个Avator结果，而Avator Repository的查询工作正常，请问这是什么原因？

排查与解决方向 #

• 关联名称冲突：你同时定义了has_one :avator和has_many :avators（单复数差异），这会导致Hanami的查询聚合逻辑混淆。框架可能误将aggregate(:avators)匹配到单例关联的处理逻辑，从而只返回一条结果。建议移除不需要的has_one :avator关联，或者将单例关联重命名为primary_avator这类完全区分的名称。

• 实体属性类型问题：检查Owner实体类，确保avators属性被定义为集合类型（比如Array(Avator)）。Hanami将多行SQL查询结果映射为实体时，需要明确集合类型才能把多个Avator实例打包进Owner的avators属性中，否则可能只会保留最后一条关联记录。

• 关联表数据验证：直接查询数据库的oneships表，确认每个Owner对应的关联记录是否确实有两条，且owner_id和avator_id的匹配关系完全正确，没有重复或错误数据。

• 调整查询语法：尝试用include替代aggregate来加载关联集合（Hanami部分版本的语法差异），或者手动构建关联查询：

def find_with_avators(id)
  where(id: id).include(:avators).map_to(Owner).one
end

也可以用join方式手动关联表：

def find_with_avators(id)
  join(:oneships, :avators).where(owners__id: id).map_to(Owner).one
end

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