Windows IIS服务器上WordPress调用oEmbed代理接口出现401 rest_forbidden错误求助

针对你在Windows Server 2019 IIS上部署的WordPress 5.6.2（PHP7.4.16）遇到的Elementor图库调用/wp-json/oembed/1.0/proxy返回401错误的问题，我整理了以下排查和解决步骤：

1. 调整oEmbed代理的权限要求 #

WordPress默认情况下，oEmbed代理请求（/wp-json/oembed/1.0/proxy）需要用户拥有edit_posts权限，普通访客没有这个权限，所以会触发401禁止错误。你可以通过钩子修改权限要求，让访客也能访问：

将以下代码添加到主题的functions.php文件，或者使用代码片段插件：

add_filter( 'rest_oembed_proxy_request_capability', function() {
    // 将权限从默认的edit_posts改为read，允许所有能读取内容的用户（包括访客）访问代理
    return 'read';
});

添加后刷新页面，重新测试代理URL是否正常。

2. 检查IIS服务器的认证与重写设置 #

因为部署在IIS上，服务器端的认证规则可能拦截了请求：

• 启用匿名认证：打开IIS管理器，找到你的WordPress站点，进入「认证」功能，确保「匿名认证」是启用状态，暂时禁用其他不必要的认证（比如Windows认证），测试是否解决401问题。
• 验证URL重写规则：检查站点根目录的web.config文件，确保WordPress的重写规则正确，能将REST API请求转发到index.php。正确的基础重写规则示例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="WordPress" patternSyntax="Wildcard">
                    <match url="*" />
                    <conditions>
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

3. 排查安全插件与防火墙限制 #

很多安全插件会限制REST API的代理请求，防止滥用：

• 检查你安装的安全插件（比如Wordfence、iThemes Security），寻找是否有「REST API限制」「oEmbed代理控制」相关的选项，将/wp-json/oembed/1.0/proxy添加到白名单，或者直接允许oEmbed代理请求。
• 检查服务器上的防火墙、IIS URL扫描模块，确认没有规则拦截包含/proxy路径的请求。

4. 清除Elementor缓存并验证设置 #

Elementor的缓存或配置可能导致请求异常：

• 进入Elementor后台，点击「工具」>「通用」，点击「重新生成CSS」和「同步库」，然后清除站点的所有缓存（包括浏览器缓存）。
• 检查Elementor图库设置，确认没有启用外部图片的额外安全验证选项，比如强制本地存储或URL白名单限制。

5. 验证WordPress核心文件完整性 #

如果核心文件损坏，也可能导致权限逻辑异常：

• 进入WordPress后台，点击「工具」>「站点健康」>「信息」，找到「文件完整性」选项，检查是否有核心文件被修改或缺失。如果有问题，点击「修复文件」按钮（需要启用WP_DEBUG或使用官方修复工具）。

内容的提问来源于stack exchange，提问作者Kevin.A