Laravel+PostgreSQL调用自定义函数报错SQLSTATE[42883]求助

问题重现 #

我在使用Laravel结合PostgreSQL时遇到以下错误：

SQLSTATE[42883]: Undefined function: 7 ERROR: function paymentrun(integer, date, double precision, text) does not exist LINE 1: SELECT paymentRun( ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. (SQL: SELECT paymentRun( :buyer_id::integer, :payment_date::DATE, :paid_amount::double precision, :paydetails::text);)

我定义的PostgreSQL函数开头部分如下：

CREATE FUNCTION "paymentRun"(buyer_id integer, payment_date DATE, paid_amount double precision, payDetails text) RETURNS VOID AS $$ 
DECLARE 
    row_STab "SearchTable"%rowtype; 
    curProd "KeysForSale"%rowtype; 
    totalPrice double precision; 
    returnedPID integer; 
BEGIN 
-- 函数主体省略

Laravel中的调用代码：

DB::select("SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;"); 
DB::select('BEGIN TRANSACTION;'); 

$sendToSQL = ''; 
for($i = 0; $i<session('cart_number'); $i++) 
    $sendToSQL .= '(' . $cart_array[$i] . '),'; 
$sendToSQL = rtrim($sendToSQL,","); 
$sendToSQL .= ';'; 

DB::select('INSERT INTO "SearchTable"(product_id) VALUES' . $sendToSQL); 

DB::select('SELECT paymentRun( :buyer_id::integer, :payment_date::DATE, :paid_amount::double precision, :paydetails::text);', [
    'buyer_id' => Auth::id(), 
    'payment_date' => date('Y/m/d'), 
    'paid_amount' => 10000, 
    'paydetails' =>'qualquer' 
]); 

DB::select('COMMIT;');

问题根源分析 #

这个错误的核心原因是PostgreSQL的标识符大小写敏感性：

• 当你用双引号包裹函数名"paymentRun"创建时，PostgreSQL会严格保留这个大小写格式；
• 但你调用时写的是paymentRun（没有双引号），PostgreSQL会自动将其转换为小写paymentrun，自然找不到你定义的"paymentRun"函数。

另外还有两个次要问题需要注意：

1. 参数绑定的强制转换写法冗余，Laravel的查询构建器可以自动处理类型匹配；
2. 手动管理事务的写法不够规范，Laravel提供了更安全的事务封装。

修复步骤 #

1. 修正函数调用的标识符大小写

调用函数时必须用双引号包裹函数名，保持和定义时一致：

DB::select('SELECT "paymentRun"( :buyer_id, :payment_date, :paid_amount, :paydetails);', [
    'buyer_id' => Auth::id(), 
    'payment_date' => date('Y-m-d'), // 注意PostgreSQL标准日期格式是Y-m-d，不是Y/m/d
    'paid_amount' => 10000, 
    'paydetails' =>'qualquer' 
]);

2. 修正日期格式

PostgreSQL默认的日期格式是YYYY-MM-DD，你之前用date('Y/m/d')生成的格式可能导致类型转换错误，改为date('Y-m-d')或者直接传递Carbon实例更稳妥：

// 需要先引入Carbon：use Carbon\Carbon;
'payment_date' => Carbon::today()->toDateString(),

3. 使用Laravel规范的事务写法

手动执行BEGIN/COMMIT容易出错，推荐使用Laravel的DB::transaction()闭包，它会自动处理事务的提交和回滚：

DB::transaction(function () use ($cart_array) {
    // 设置事务隔离级别
    DB::statement("SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;");

    // 优化批量插入写法，避免循环拼接SQL的冗余
    $values = collect($cart_array)->map(function($id) {
        return "($id)";
    })->implode(',');
    DB::statement('INSERT INTO "SearchTable"(product_id) VALUES ' . $values);

    // 调用自定义函数
    DB::select('SELECT "paymentRun"( :buyer_id, :payment_date, :paid_amount, :paydetails);', [
        'buyer_id' => Auth::id(), 
        'payment_date' => Carbon::today()->toDateString(),
        'paid_amount' => 10000, 
        'paydetails' =>'qualquer' 
    ]);

}, 3); // 可选：设置重试次数，处理序列化隔离级别下的死锁场景

4. 验证函数存在性（可选）

如果还是有问题，可以先在PostgreSQL客户端执行以下命令确认函数是否存在，以及参数类型是否完全匹配：

SELECT proname, proargtypes FROM pg_proc WHERE proname = 'paymentRun';

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