Laravel控制器调用Oracle存储函数返回值异常求助

问题背景 #

维护基于MVC架构的大型Laravel项目，需调用Oracle数据库（Oracle SQL Developer管理）的存储函数fun_adeuda_mont获取用户欠款金额。异常现象：直接在数据库中传入参数调用函数能返回正确结果，但通过Laravel控制器用相同参数调用时始终返回0。该函数包含默认参数，调用语法与另一正常工作的函数fun_tiene_titulo一致，怀疑问题与默认参数相关，需排查Laravel生成的查询语句或找到正确返回值的方法。

相关代码 #

正常工作的函数调用代码 #

public function tieneTitulo(Request $request){
    $ope = $request->operatoria;
    $barrio = $request->barrio;
    $adju = $request->adju;

    $query = "SELECT usua400.fun_tiene_titulo(:ope, :barrio, :adju, 'T') as respuesta from dual";
    $resultados = DB::select(DB::raw($query), ['ope' => $ope, 'barrio' => $barrio, 'adju' => $adju]);

    //dd($resultados);
    if (empty($resultados)) {
        return response()->json(['message' => 'Sin datos.']);
    } else {
        return response()->json($resultados[0]);
    }
}

返回异常的函数调用代码 #

public function consultarAdeuda(Request $request) {
    $ope = $request->operatoria;
    $barrio = $request->barrio;
    $adju = $request->adju;
    $fecha = Carbon::createFromFormat('d/m/y', '15/07/24')->format('d-m-y');

    try {
        $result = DB::select('SELECT iprodha.fun_adeuda_mont(:ope, :barrio, :adju, :fecha) as respuesta from dual', [
            'ope' => $ope,
            'barrio' => $barrio,
            'adju' => $adju,
            'fecha' => $fecha,
        ]);

        if ($result === null){
            return response()->json(['respuesta' => 'Sin datos.']);
        } else {
            return response()->json(['respuesta' => $result[0]->respuesta]);
        }
    } catch (\Exception $e) {
        return response()->json(['message' => 'Ocurrió un error al ejecutar la consulta: .'], $e->getMessage());
    }
}

路由代码 #

Route::get('juridicos/juicios/consultarAdeuda', [JuiciosController::class, 'consultarAdeuda'])->name('juridicos.juicios.consultarAdeuda');

排查步骤与解决方案 #

1. 查看Laravel生成的实际SQL语句 #

确认Laravel发送给Oracle的查询是否正确，可启用查询日志：

// 在consultarAdeuda方法开头添加
DB::enableQueryLog();
// 执行查询代码后
$queries = DB::getQueryLog();
dd($queries); // 输出完整SQL和绑定参数

对比日志中的SQL与你在Oracle SQL Developer中执行的语句，检查参数格式、值是否完全一致。

2. 修正日期参数格式 #

代码中日期格式化为d-m-y，可能与Oracle预期格式不匹配，导致函数内部逻辑判断失败：

• 直接传递Carbon实例，让Laravel Oracle驱动自动处理格式：

  $fecha = Carbon::createFromFormat('d/m/y', '15/07/24');
  

• 或转换为Oracle标准日期格式：

  $fecha = Carbon::createFromFormat('d/m/y', '15/07/24')->format('Y-m-d');
  

3. 验证默认参数的传递逻辑 #

若函数包含默认参数，需确保参数传递的顺序/名称与函数定义一致：

• 查看fun_adeuda_mont的参数定义，确认传递的参数数量、顺序是否正确；
• 尝试用命名参数调用（Oracle 12c+支持），避免顺序错误：

  SELECT iprodha.fun_adeuda_mont(p_ope => :ope, p_barrio => :barrio, p_adju => :adju, p_fecha => :fecha) as respuesta from dual
  

4. 检查数据库账号权限 #

Laravel使用的数据库账号可能缺少函数内部依赖的表/视图访问权限，导致函数返回默认值0：

• 确认账号对fun_adeuda_mont有EXECUTE权限，对函数内部查询的表有SELECT权限。

5. 调试Oracle函数内部逻辑 #

在Oracle SQL Developer中调试fun_adeuda_mont，传入Laravel传递的参数，逐步执行检查逻辑分支，确认是参数、数据还是权限导致返回0。

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