WordPress authenticate过滤器未触发问题求助

我尝试使用authenticate过滤器实现自定义登录认证，但代码始终未触发。已将代码精简至核心逻辑，且确认插件已正常激活、函数存在于wp_filters数组中，但每次仍能成功登录而非被拒绝。

精简后的代码：

<?php
/**
 * Login functions
 */

add_filter('authenticate', 'ii_login_test', 30, 3);


/*
 * Custom Login
*/
function ii_login_test($user, $username, $password) {
    //return get_userdata(username_exists($username));
    return new WP_Error( 'authentication_failed', __( 'ERROR: No user record found.' ));
}

可能的原因及解决方案 #

• 过滤器优先级错误：WordPress默认认证逻辑的authenticate过滤器优先级为20，你的函数设置了30，会在默认认证之后执行。如果默认认证已通过（比如用户密码正确），后续返回的WP_Error不会覆盖已完成的认证结果。
  解决：将优先级调整为低于20的值，比如10：

  add_filter('authenticate', 'ii_login_test', 10, 3);
  

• WordPress版本兼容限制：WordPress 5.3及以上版本中，若authenticate过滤器的前置回调已返回有效WP_User对象，后续回调会被直接跳过。你的函数执行顺序靠后，自然无法影响认证结果。

• 缓存/会话残留干扰：若之前已成功登录，浏览器可能保存了会话Cookie，导致无需重新验证。可尝试清空浏览器缓存、使用隐身模式测试，或在函数中强制销毁会话：

  function ii_login_test($user, $username, $password) {
      wp_destroy_current_session();
      wp_clear_auth_cookie();
      return new WP_Error( 'authentication_failed', __( 'ERROR: No user record found.' ));
  }
  

• 未确认函数是否真的被调用：可以通过日志调试验证函数是否触发，在函数中添加日志代码：

  function ii_login_test($user, $username, $password) {
      error_log('ii_login_test已触发，用户名：' . $username); // 日志会写入wp-content/debug.log
      return new WP_Error( 'authentication_failed', __( 'ERROR: No user record found.' ));
  }
  

  同时在wp-config.php中开启调试日志：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  

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