OctoberCMS V2.1.17 插件后台列表两层关联字段搜索出现列不存在错误的求助

我来帮你拆解下这个问题的核心原因和可行的解决思路：

为什么会出现这个错误？ #

从报错的SQL语句能直接看出问题：你在SELECT子句里给lucaspalomba_packsinterieurs_etablissements.name起了别名etablissement_name，但SQL的执行顺序是WHERE子句先于SELECT子句执行——也就是说，当数据库处理WHERE条件的时候，etablissement_name这个别名还没被创建出来，自然会提示“找不到列”。

OctoberCMS的全局搜索功能默认会把列表中配置的所有字段（包括你手动添加的别名字段）直接放到WHERE条件里匹配，这就触发了这个SQL语法层面的问题。

解决办法（推荐两种方案） #

方案1：修改全局搜索逻辑，直接关联原始字段

在listExtendQuery里拦截搜索请求，把针对etablissement_name的搜索条件替换成关联表的原始字段，而不是用别名。同时保留其他字段的搜索逻辑：

public function listExtendQuery($query, $definition) {
    if($definition == "suivis"){
        $dossierProductsTableName = (new DossierProducts)->getTable();
        $dossierTableName = (new Dossier)->getTable();
        $etablissementTableName = (new Etablissement)->getTable();
        
        // 保留别名字段用于列表显示
        $query->addSelect($etablissementTableName . '.name as etablissement_name');
        $query->leftJoin($dossierTableName, $dossierTableName . '.id', '=', $dossierProductsTableName . '.dossier_id');
        $query->leftJoin($etablissementTableName, $etablissementTableName . '.id', '=', $dossierTableName . '.etablissement_id');
        
        // 处理全局搜索，替换别名对应的原始字段
        if ($searchTerm = request()->get('search')) {
            // 清除默认生成的错误条件，重新构建搜索逻辑
            $query->where(function($q) use ($searchTerm, $etablissementTableName, $dossierProductsTableName) {
                // 匹配当前表的所有字段
                $q->whereRaw("lower({$dossierProductsTableName}.*) LIKE ?", ["%".strtolower($searchTerm)."%"])
                  // 匹配关联的机构名称
                  ->orWhereRaw("lower({$etablissementTableName}.name) LIKE ?", ["%".strtolower($searchTerm)."%"])
                  // 保留原有piece和category的搜索逻辑
                  ->orWhereExists(function($subq) use ($searchTerm) {
                      $subq->select('*')
                           ->from('lucaspalomba_packsinterieurs_pieces')
                           ->whereRaw("lucaspalomba_packsinterieurs_dossiers_products.piece_id = lucaspalomba_packsinterieurs_pieces.id")
                           ->whereRaw("lower(concat(id, ' - ', name)) LIKE ?", ["%".strtolower($searchTerm)."%"]);
                  })
                  ->orWhereExists(function($subq) use ($searchTerm) {
                      $subq->select('*')
                           ->from('lucaspalomba_packsinterieurs_categories')
                           ->whereRaw("lucaspalomba_packsinterieurs_dossiers_products.categorie_id = lucaspalomba_packsinterieurs_categories.id")
                           ->whereRaw("lower(concat(id, ' - ', name)) LIKE ?", ["%".strtolower($searchTerm)."%"]);
                  });
            });
        }
    }
}

方案2：利用OctoberCMS自带的关联搜索（更符合框架最佳实践）

如果你的模型已经正确定义了关联关系：

• DossierProducts模型里有public $belongsTo = ['dossier' => Dossier::class];
• Dossier模型里有public $belongsTo = ['etablissement' => Etablissement::class];

那你可以直接在列表配置文件（比如_list_suivis.htm）里添加专门的过滤器字段，让OctoberCMS自动处理关联搜索，完全不用自己写JOIN：

# 列表过滤器部分
filters:
    fields:
        etablissement_name:
            label: 机构名称
            type: text
            # 直接关联到两层嵌套的关联字段
            conditions: dossier.etablissement.name LIKE :value
            relation: dossier.etablissement

# 列表列定义部分
columns:
    # ...其他列
    etablissement_name:
        label: 机构名称
        relation: dossier.etablissement
        select: name

这种方式更简洁，也避免了手动写SQL的潜在问题，同时保留了全局搜索的体验（或者你可以单独用这个过滤器来搜索机构名称）。

额外提醒 #

不管用哪种方案，都要确保模型之间的关联关系已经正确配置，这是OctoberCMS处理关联数据的基础，能帮你避免很多手动写SQL的麻烦。

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