Laravel集成Mollie时Webhook返回500错误求助

核心错误原因 #

日志报错Method App\Http\Controllers\webHookController::handle does not exist，直接指向两个问题：

1. 路由配置与控制器方法不匹配：你的路由将Mollie Webhook请求指向了handle方法，但实际控制器中定义的处理方法是handleWebhookNotification
2. 控制器类名大小写错误：Laravel遵循PSR-4自动加载规范，控制器类名应为大驼峰格式（如WebhookController），但错误日志中显示的是小写开头的webHookController，会导致类找不到或方法匹配失败

具体修复步骤 #

1. 修正Webhook路由配置 #

打开routes/api.php（Webhook建议使用API路由，无需Session验证），确保路由指向正确的控制器类和方法：

use App\Http\Controllers\WebhookController;

Route::post('/webhooks/mollie', [WebhookController::class, 'handleWebhookNotification'])
    ->name('webhooks.mollie');

注意：如果之前用的是web.php路由，需确保该路由排除CSRF验证，在App\Http\Middleware\VerifyCsrfToken的$except数组中添加：

protected $except = [
    '/webhooks/mollie',
];

2. 修正控制器类名与命名空间 #

确保你的控制器文件名为WebhookController.php，文件内容的类名和命名空间正确：

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Mollie\Laravel\Facades\Mollie;
use App\Models\Order;
use Illuminate\Support\Facades\Log;

class WebhookController extends Controller
{
    public function handleWebhookNotification(Request $request) 
    {
        // 你的原有代码...
    }
}

错误日志中的webHookController是大小写错误，Laravel的控制器类必须是大驼峰命名，否则自动加载会失败。

3. 验证Webhook URL一致性 #

检查代码中设置的Webhook URL是否与路由完全匹配：

// 原有代码中的Webhook URL设置
$webhookUrl = route('webhooks.mollie');

if(App::environment('local')) {
   $webhookUrl = 'https://5d25-84-199-205-243.eu.ngrok.io/webhooks/mollie';
};

确保Ngrok URL后的路径/webhooks/mollie和路由定义的路径完全一致。

4. 补充订单模型可填充字段 #

确保Order模型的$fillable数组包含status字段，否则无法通过$order->status = 'paid'更新：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Order extends Model
{
    protected $fillable = ['name', 'note', 'total', 'status'];
}

调试建议 #

在handleWebhookNotification方法开头添加日志，方便确认Webhook是否被触发：

public function handleWebhookNotification(Request $request) 
{
    Log::info('Mollie Webhook received', ['request_data' => $request->all()]);
    // 原有代码...
}

执行支付测试后，查看storage/logs/laravel.log，确认日志是否生成，以此判断Webhook是否正常到达。

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