Laravel 11跨数据库关联查询报ORA-00942错误的解决方法

问题场景 #

使用Laravel 11 + Oracle数据库，存在两个模型：

• Order模型使用db_order连接，对应orders表，与Event模型为belongsTo关联
• Event模型使用db_event连接，对应events表，与Order模型为hasMany关联

查询订单列表并按事件名称搜索时，触发ORA-00942错误，提示子查询中的EVENTS表不存在。

模型代码 #

Order模型 #

class Order extends Eloquent
{
    use HasFactory;

    protected $connection = 'db_order';
    protected $table = 'orders';

    public function event()
    {
        return $this->belongsTo(Event::class, 'event_id', 'id');
    }
}

Event模型 #

class Event extends Eloquent
{
    use HasFactory;

    protected $connection = 'db_event';
    protected $table = 'events';

    public function orders()
    {
        return $this->hasMany(Order::class);
    }
}

原查询代码 #

$query = Order::with('event');

if (isset($request->name_search)) {
    $searchText = "'%" . trim($request->name_search) . "%'";

    $query->where('id', 'like', $searchText)
        ->orWhere('transaction_id', 'like', $searchText)
        ->orWhere('user_id', 'like', $searchText)
        ->orWhere('customer_name', 'like', $searchText)
        ->orWhereHas('event', function($q) use ($searchText) {
            $q->where('name', 'like', $searchText);
        });
}

$orders = $query->orderBy('orders.id', 'DESC')->paginate(20);

错误信息 #

Error Code : 942 
Error Message : ORA-00942: table or view does not exist 
Position : 166 
Statement : select count(*) as aggregate from "ORDERS" where "ID" like :p0 or "TRANSACTION_ID" like :p1 or "USER_ID" like :p2 or "CUSTOMER_NAME" like :p3 or exists (select * from "EVENTS" where "ORDERS"."EVENT_ID" = "EVENTS"."ID" and "NAME" like :p4) 
Bindings : ['%abc%','%abc%','%abc%','%abc%','%abc%']

解决方法 #

1. 修正搜索文本的引号问题 #

手动添加的单引号会破坏Laravel的参数绑定机制，查询构建器会自动处理参数的引号包裹，因此需要去掉手动添加的单引号：

$searchText = '%' . trim($request->name_search) . '%';

2. 显式指定关联查询的数据库连接 #

执行whereHas时，Eloquent默认使用主模型（Order）的db_order连接查询关联表，但events表在db_event连接的数据库中，因此需要在闭包中显式切换连接：

->orWhereHas('event', function($q) use ($searchText) {
    $q->on('db_event') // 指定使用Event模型的数据库连接
      ->where('name', 'like', $searchText);
});

修正后的完整查询代码 #

$query = Order::with('event');

if (isset($request->name_search)) {
    $searchText = '%' . trim($request->name_search) . '%';

    $query->where('id', 'like', $searchText)
        ->orWhere('transaction_id', 'like', $searchText)
        ->orWhere('user_id', 'like', $searchText)
        ->orWhere('customer_name', 'like', $searchText)
        ->orWhereHas('event', function($q) use ($searchText) {
            $q->on('db_event')
              ->where('name', 'like', $searchText);
        });
}

$orders = $query->orderBy('orders.id', 'DESC')->paginate(20);

原理说明 #

跨数据库关联查询时，Eloquent不会自动切换到关联模型的数据库连接，默认沿用主模型的连接，因此必须手动指定关联查询使用的连接才能找到对应表。同时，手动添加单引号会导致SQL参数绑定错误，破坏查询逻辑。

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