关于禁用WooCommerce WordPress REST API及解决其阻断基础认证问题的技术求助

API 探路者

2026-4-20

兄弟，我之前也踩过一模一样的坑！WooCommerce激活后确实会干扰WordPress REST API的基础认证机制，尤其是它自带的OAuth认证会优先接管请求，导致你原来的基础认证（用户名+密码）直接失效。给你几个亲测有效的解决思路：

优先尝试WooCommerce官方认证方式
先去后台「WooCommerce > 设置 > 高级 > REST API」页面，创建一组新的API密钥（消费者密钥+消费者密码）。WooCommerce默认会优先使用自己的OAuth1.0a认证体系，这是官方推荐的安全方案，如果你能调整应用适配这种认证方式，大概率能直接解决问题。

强制启用WordPress原生基础认证
如果必须要用用户名+密码的基础认证，你可以加一段自定义代码到主题的functions.php文件，或者做个简单的自定义插件，让WordPress的基础认证逻辑抢在WooCommerce之前执行：

add_filter('rest_authentication_errors', function($result) {
    // 已有认证结果则直接返回
    if (!empty($result)) {
        return $result;
    }
    // 检查是否携带基础认证信息
    if (!isset($_SERVER['PHP_AUTH_USER'])) {
        return null;
    }
    // 执行WordPress原生账号密码认证
    $user = wp_authenticate($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']);
    if (is_wp_error($user)) {
        return new WP_Error(
            'rest_authentication_failed',
            $user->get_error_message(),
            array('status' => 401)
        );
    }
    // 设置当前登录用户
    wp_set_current_user($user->ID);
    return null;
}, 1);

这段代码的优先级设为1，会在WooCommerce的认证逻辑之前触发，确保你的基础认证请求能被正常识别。

排查插件冲突问题
有时候锅不一定是WooCommerce的，可能是它和其他插件的冲突。比如一些安全类插件（像Wordfence）也会对REST API的认证做限制。你可以先暂时禁用所有其他插件，只留WooCommerce和你的应用相关插件，看看问题是否消失。如果恢复正常了，再逐个启用插件排查，找到搞事情的那个。
检查.htaccess配置是否干扰
WooCommerce可能会修改根目录的.htaccess文件，添加的规则可能会阻止基础认证的头部信息传递。你可以打开这个文件，看看有没有类似下面的规则：
```
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
```
如果存在这条规则，尝试在前面加#注释掉它，然后测试认证是否恢复正常。有些服务器环境对这条规则的支持不好，反而会导致Authorization头部丢失，进而让基础认证失效。

备注：内容来源于stack exchange，提问作者Thrills Byte