0

0

Laravel AJAX DELETE 请求方法不匹配问题及解决方案

霞舞

霞舞

发布时间:2025-09-15 13:05:22

|

458人浏览过

|

来源于php中文网

原创

laravel ajax delete 请求方法不匹配问题及解决方案

本文旨在解决Laravel应用中,当尝试通过AJAX发送DELETE请求时,遇到的“GET method is not supported for this route”错误。我们将深入探讨导致此问题的原因,并提供一个结合AJAX和Laravel方法伪造(Method Spoofing)机制的完整解决方案,确保DELETE请求能够被正确路由和处理。

理解问题:GET 方法不受支持

当您在Laravel中定义了一个 Route::delete() 路由,但尝试通过前端 标签或配置不当的 AJAX 请求来触发时,很可能会遇到“GET method is not supported for this route. Supported methods: POST.”这样的错误。这通常是由于以下几个原因造成的:

  1. 标签的默认行为: HTML中的 标签默认会发起一个 GET 请求到其 href 属性指向的URL。即使您在JavaScript中尝试通过AJAX发送 DELETE 请求,如果 标签的默认行为没有被阻止,浏览器仍会先发起一个 GET 请求,导致路由匹配失败。
  2. HTTP 方法伪造的缺失: 某些浏览器或环境对 DELETE、PUT、PATCH 等非 GET/POST 请求的支持可能不够完善,或者在特定的AJAX库配置下,服务器端无法直接识别这些方法。Laravel为了解决这个问题,引入了方法伪造(Method Spoofing)机制。

在Laravel中,Route::delete('operDel/{id}', ...) 明确要求请求方法必须是 DELETE。如果服务器收到的请求方法是 GET,自然会抛出方法不匹配的错误。

Laravel 中的方法伪造 (Method Spoofing)

HTTP 协议定义了多种请求方法,如 GET、POST、PUT、DELETE、PATCH 等。然而,并非所有客户端(如旧版浏览器)或服务器都完全支持所有这些方法。为了在Web应用中模拟 PUT、DELETE 或 PATCH 请求,Laravel 允许通过在 GET 或 POST 请求中包含一个特殊的 _method 参数来“伪造”HTTP 方法。

当Laravel接收到一个 GET 或 POST 请求,并且请求数据(无论是表单数据还是查询字符串)中包含 _method 参数时,Laravel的 MethodOverrideMiddleware 会拦截该请求,并将其视为 _method 参数指定的方法(例如 DELETE)。这样,即使实际的HTTP请求方法是 GET 或 POST,Laravel的路由系统也能正确匹配到 Route::delete() 等路由。

解决方案:结合 AJAX 和方法伪造

解决此问题的关键在于:

  1. 阻止 标签的默认 GET 行为。
  2. 在 AJAX 请求中明确告知 Laravel 实际的意图是 DELETE,即使请求的传输类型是 GET 或 POST。

下面是结合前端 Blade 视图、JavaScript (AJAX) 和 Laravel 后端路由/控制器代码的完整解决方案。

Narration Box
Narration Box

Narration Box是一种语音生成服务,用户可以创建画外音、旁白、有声读物、音频页面、播客等

下载

1. 前端 Blade 视图 (.blade.php)

保持 标签的结构不变,但其 href 属性将仅用于获取 URL,实际的导航行为将被 JavaScript 阻止。

Delete

{{-- 确保页面中有CSRF token meta标签 --}}

2. JavaScript (AJAX) 调整

这是核心的修改部分。我们需要在 $.ajax 调用中进行以下关键调整:

$(document).on('confirm', function (e) {
    var ele = e.target;
    e.preventDefault(); // 阻止标签的默认GET请求行为

    // 获取CSRF token
    var csrfToken = $('meta[name="csrf-token"]').attr('content');
    // 获取要删除的ID
    var id = $(ele).data('id');

    $.ajax({
        url: ele.href, // 或者直接使用 "operDel/" + id
        type: 'get', // 使用GET或POST作为实际传输类型
        headers: {
            'X-CSRF-TOKEN': csrfToken // 发送CSRF token
        },
        data: {
            "id": id,
            "_method": 'DELETE', // 关键:通过_method参数伪造DELETE方法
            "_token": csrfToken // 也可以在这里再次传递token,但headers已足够
        },
        success: function (data) {
            if (data['success']) {
                $("#" + data['tr']).slideUp("slow");
                alert(data['success']);
            } else if (data['error']) {
                alert(data['error']);
            } else {
                alert('Whoops Something went wrong!!');
            }
        },
        error: function (data) {
            // 改进错误处理,显示服务器返回的详细错误信息
            if (data.responseJSON && data.responseJSON.message) {
                alert('Error: ' + data.responseJSON.message);
            } else {
                alert('An unexpected error occurred: ' + data.responseText);
            }
        }
    });
    // return false; // 在e.preventDefault()后,通常不需要再return false
});

3. 后端 Laravel 路由 (routes/web.php)

路由定义保持不变,因为 Laravel 的方法伪造机制会使其正确匹配。

Route::delete('operDel/{id}', '\App\Http\Controllers\OperationController@destroy')
    ->name('operDel')
    ->middleware('auth');

4. 后端 Laravel 控制器 (app/Http/Controllers/OperationController.php)

控制器方法也保持不变,因为它接收到的请求已经被 Laravel 的中间件处理为 DELETE 请求。

delete();

        return response()->json([
            'success' => "Product Deleted successfully.",
            'tr' => 'tr_' . $id
        ]);
    }
}

注意事项与最佳实践

  • 阻止默认事件: 始终确保在 AJAX 请求中正确使用 e.preventDefault() 来阻止 标签或其他元素的默认行为,以避免不必要的页面跳转或 GET 请求。
  • 理解方法伪造: _method 参数是 Laravel 框架特有的机制,用于解决浏览器对某些 HTTP 方法支持不足的问题。在处理 PUT、DELETE、PATCH 请求时,如果不是通过原生表单提交且指定了 method="POST" 并包含 _method 隐藏字段,或者不是通过支持这些方法的 AJAX 请求,就可能需要用到它。
  • CSRF 保护: 在所有修改数据的请求(POST, PUT, DELETE 等)中,务必包含 CSRF 令牌,以防止跨站请求伪造攻击。Laravel 提供了多种方式来获取和发送 CSRF 令牌。
  • 错误处理: 完善前端 AJAX 请求的 error 回调函数,提供清晰的用户反馈。后端控制器也应返回有意义的错误信息,便于调试。
  • URL 构建: 在 AJAX 中,使用 ele.href 获取 URL 是方便的,但也可以直接根据路由名称和 ID 动态构建 URL,例如 '/operDel/' + id。
  • 语义化 HTTP 方法: 尽管使用了方法伪造,但从代码逻辑上,我们仍然应该坚持使用语义化的 HTTP 方法(如 DELETE 用于删除操作),这有助于代码的可读性和维护性。

通过以上调整,您的 Laravel 应用将能够正确处理通过 AJAX 发送的 DELETE 请求,避免方法不匹配的错误,并提供流畅的用户体验。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

1977

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1295

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1204

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

948

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1400

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1229

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1439

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1303

2023.11.13

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

7

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号