自定义WooCommerce端点为何需多次重置固定链接？

咱们先拆解下问题根源：你现在的端点注册逻辑是仅当用户登录时才触发，但WordPress的重写规则是全局缓存的——这意味着如果服务器的重写规则缓存生成时没有用户登录，这些自定义端点的规则根本不会被纳入缓存，所以部署后就会出现404，必须手动重置固定链接来刷新缓存。结合你提到的web.config怀疑点，咱们一步步解决：

第一步：调整端点注册时机（核心修复） #

把端点的注册从登录判断里抽出来，不管用户是否登录，都要在init钩子全局注册端点。毕竟重写规则是全局生效的，至于未登录用户访问端点后的权限控制，可以放到内容输出环节处理。修改后的代码如下：

// 主插件文件中的函数
function knp_load_first(){
    // 不管用户登录状态，先加载端点类
    new KnpvEndPoints();
}
add_action('plugins_loaded', 'knp_load_first');

class KnpvEndPoints {
    public function __construct(){
        // 全局注册重写规则，不要绑定登录状态
        add_action('init', array($this, 'knp_portal_rewrite'));
        // 端点内容回调保留，在这里做登录校验
        add_action('woocommerce_account_product-submissions_endpoint', array($this, 'knp_product_submissions_content'));
    }

    public function knp_portal_rewrite(){
        add_rewrite_endpoint('product-submissions', EP_PAGES);
    }

    public function knp_product_submissions_content(){
        // 在这里做登录判断，未登录则跳转登录页
        if (!is_user_logged_in()) {
            wp_redirect(wp_login_url(get_permalink()));
            exit;
        }
        // 输出你的自定义内容
    }
}

这样调整后，重写规则会在每次init时被注册，固定链接缓存里会稳定包含这些端点的规则，部署后就不需要手动重置了。

第二步：检查IIS服务器的web.config配置 #

如果你是Windows IIS服务器，确保web.config里的重写规则能正确转发请求到WordPress的index.php，这是自定义端点生效的基础。以下是标准的WordPress web.config模板，你可以对比修改：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="WordPress Rewrite" stopProcessing="true">
                    <match url=".*" />
                    <conditions logicalGrouping="MatchAll">
                        <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>
        <defaultDocument>
            <files>
                <clear />
                <add value="index.php" />
            </files>
        </defaultDocument>
    </system.webServer>
</configuration>

重点确认：

• 重写规则要把所有非文件/目录的请求转发到index.php，WordPress才能处理自定义路由
• 部署时不要覆盖这个正确的配置，建议把它加入你的版本控制和部署流程

第三步：添加自动刷新重写规则的钩子（可选优化） #

如果你的部署流程允许，可以在插件激活时自动刷新重写规则，彻底免去手动操作的麻烦。在主插件文件里添加激活/停用钩子：

// 插件激活时自动刷新重写规则
register_activation_hook(__FILE__, 'knp_flush_rewrites_on_activation');
function knp_flush_rewrites_on_activation(){
    // 先注册端点，再刷新规则
    new KnpvEndPoints();
    flush_rewrite_rules();
}

// 插件停用时清理规则（可选）
register_deactivation_hook(__FILE__, 'knp_flush_rewrites_on_deactivation');
function knp_flush_rewrites_on_deactivation(){
    flush_rewrite_rules();
}

这样每次部署后重新激活插件（或者你的部署脚本自动触发激活），都会自动刷新重写规则，完全不用手动去后台重置固定链接。

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