本文旨在解决wordpress中ajax请求对非登录用户返回400 “bad request” 错误的问题。核心原因在于wordpress的wp_ajax_{$action}钩子仅对已登录用户生效。教程将详细阐述如何通过同时使用wp_ajax_{$action}和wp_ajax_nopriv_{$action}钩子，确保ajax功能在所有用户状态下（包括已登录和未登录）均能正常运行，并提供示例代码和最佳实践。
理解WordPress AJAX请求与400错误
在WordPress开发中，使用AJAX（Asynchronous JavaScript and XML）与后端PHP进行交互是一种常见的模式，尤其是在不刷新页面的情况下更新内容。通常，我们会将AJAX请求发送到WordPress的admin-ajax.php文件，并通过action参数指定要执行的后端函数。
然而，开发者经常会遇到一个令人困惑的问题：AJAX请求在已登录的用户账户和浏览器中运行良好，但在切换到不同的浏览器、谷歌账户或作为未登录用户访问时，却会收到来自admin-ajax.php的400 “Bad Request” 错误。即使后端逻辑看似简单，仅进行数据查询并以JSON格式返回，这个问题依然存在。
这种现象的根本原因在于WordPress处理AJAX请求的机制。WordPress为不同的用户状态提供了不同的钩子来注册AJAX处理函数。
核心问题：用户状态与AJAX钩子
WordPress提供了两个主要的动作钩子来处理AJAX请求：
wp_ajax_{$action}: 这个钩子专门用于处理已登录用户发起的AJAX请求。只有当用户登录到WordPress后台时，与此钩子关联的函数才会被触发。wp_ajax_nopriv_{$action}: 这个钩子则用于处理未登录用户（即访客）发起的AJAX请求。当用户未登录时，如果存在与此钩子关联的函数，它将被执行。
如果您的AJAX请求在已登录状态下工作正常，但在未登录状态下返回400错误，那么很可能您只使用了wp_ajax_{$action}钩子，而忽略了wp_ajax_nopriv_{$action}。当未登录用户发送请求时，WordPress找不到对应的处理函数，因此返回400错误。
解决方案：同时注册登录和未登录用户的AJAX钩子
要解决这个问题，您需要确保您的AJAX处理函数同时注册到这两个钩子上。这样，无论用户是否登录，WordPress都能找到并执行正确的后端逻辑。
示例代码：后端PHP
假设您有一个名为get_content_wino的AJAX操作，其对应的处理函数也叫get_content_wino。正确的注册方式如下：
'Invalid request' ) ); // die();}// 假设 read_file() 函数的定义（仅为示例，实际应根据需求实现）function read_file() { // 这里可以是从文件、数据库、API等读取数据的逻辑 // 假设返回一个JSON字符串 return json_encode( array( 'status' => 'success', 'data' => 'This is content from the server.' ) );}?>
通过以上修改，您的get_content_wino函数将对所有用户（无论是登录还是未登录）都可用，从而解决400 “Bad Request” 错误。
示例代码：前端JavaScript (AJAX请求)
前端的AJAX请求代码保持不变，因为它通过action参数来标识要执行的后端操作，而WordPress会根据用户状态自动匹配正确的钩子。
// 确保 ajaxurl 已在WordPress中正确定义，例如通过 wp_localize_script// var ajaxurl = 'path/to/wp-admin/admin-ajax.php';$.ajax({ type: 'post', url: ajaxurl, // WordPress 全局变量，指向 admin-ajax.php data: { 'action': 'get_content_wino' // 匹配后端注册的 action 名称 }, success: function(data) { console.log(data); console.log("fetch ok"); // 在这里处理成功返回的数据 }, error: function(errorThrown) { console.log(errorThrown); // 在这里处理错误情况 }});
注意事项与最佳实践
安全性（Nonce验证）:虽然上述解决方案解决了400错误，但在生产环境中，强烈建议为AJAX请求添加Nonce（一次性令牌）验证，以防止跨站请求伪造（CSRF）攻击。
在PHP中生成Nonce:
// 在某个地方（例如主题的 functions.php 或插件初始化时）add_action( 'wp_enqueue_scripts', 'my_ajax_scripts' );function my_ajax_scripts() { wp_enqueue_script( 'my-ajax-script', get_template_directory_uri() . '/js/my-ajax-script.js', array('jquery'), null, true ); wp_localize_script( 'my-ajax-script', 'my_ajax_object', array( 'ajax_url' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'my_ajax_nonce' ) // 创建一个Nonce ) );}
在前端AJAX请求中发送Nonce:
$.ajax({ type: 'post', url: my_ajax_object.ajax_url, data: { 'action': 'get_content_wino', 'nonce': my_ajax_object.nonce // 发送Nonce }, // ...});
在PHP处理函数中验证Nonce:
function get_content_wino() { if ( !isset($_POST['nonce']) || !wp_verify_nonce($_POST['nonce'], 'my_ajax_nonce') ) { wp_send_json_error( 'Security check failed' ); // 使用 wp_send_json_error 返回错误 die(); } // ... 后续逻辑}
请注意，wp_verify_nonce对于未登录用户同样有效。
die() 的使用:在AJAX处理函数的末尾，务必使用die()（或wp_die()）来终止WordPress的正常执行流程。否则，WordPress会继续加载整个页面，导致AJAX响应中包含多余的HTML内容，这会干扰前端对JSON数据的解析。
返回JSON数据:为了更好地与前端JavaScript交互，建议使用WordPress提供的wp_send_json(), wp_send_json_success(), 或 wp_send_json_error() 函数来返回JSON格式的数据。这些函数会自动设置正确的HTTP头，并调用die()。
// 替代 echo read_file(); die();$data_to_send = array( 'message' => 'Content fetched successfully', 'content' => '...' );wp_send_json_success( $data_to_send ); // 返回 { "success": true, "data": { ... } }// 或// wp_send_json_error( array( 'message' => 'Failed to fetch content' ) );
错误处理与调试:
浏览器开发者工具: 始终检查浏览器的网络（Network）选项卡，查看AJAX请求的响应状态码、响应内容和请求头，这对于诊断问题至关重要。WordPress调试模式: 开启WordPress的调试模式（define(‘WP_DEBUG’, true);），并检查debug.log文件，可能会发现后端PHP的错误信息。服务器日志: 检查Web服务器（如Apache, Nginx）的错误日志，可能会有更底层的错误报告。
总结
解决WordPress AJAX请求在非登录用户下返回400 “Bad Request” 错误的关键在于理解并正确使用wp_ajax_{$action}和wp_ajax_nopriv_{$action}这两个钩子。通过同时注册您的AJAX处理函数到这两个钩子，可以确保您的AJAX功能在所有用户状态下都能稳定运行。同时，结合Nonce验证、正确使用die()以及利用wp_send_json()系列函数，将有助于构建更安全、健壮和专业的WordPress AJAX解决方案。
以上就是WordPress AJAX 400错误：解决非登录用户请求失败的通用方案的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1337362.html
微信扫一扫 
支付宝扫一扫 
