WordPress中用PRG模式解决CSV导入MySQL的表单重复提交问题

我太懂这种头疼的感觉了——在WordPress里做CSV导入MySQL，好不容易写完逻辑，结果刷新页面就重复上传，试了PRG模式却总卡壳。这主要是因为WordPress有自己的请求处理流程，直接用原生PHP的重定向逻辑很容易踩坑。下面给你梳理下适配WordPress环境的PRG解决方案，附修改后的代码示例：

WordPress的页面加载依赖全局钩子和状态管理，普通的header("Location: ...")经常没完全终止当前请求，或者没清理POST上下文，导致刷新时浏览器还是会重复发送之前的POST数据。必须用WordPress原生的工具来实现PRG，才能完美适配它的机制。

核心要做三件事：用WP原生重定向函数、添加CSRF验证、重定向后用GET参数传递状态

修改后的完整代码示例 #

<?php
/*** CSV导入处理逻辑 ***/
// 1. 先做CSRF验证，这既是安全要求，也能过滤刷新的重复请求
if (isset($_POST["submit"]) && check_admin_referer('csv_import_action', 'import_nonce')) {
    if (!empty($_FILES['file']['name'])) {
        $filename_parts = explode('.', $_FILES['file']['name']);
        // 👇这里放你的CSV解析、MySQL导入逻辑
        // 比如：验证文件是CSV格式、读取文件内容、批量插入数据库等
        
        // 假设导入逻辑执行成功
        $import_result = 'success';
        
        // 2. 使用WordPress官方重定向函数，带状态参数跳回当前页面
        $redirect_url = add_query_arg(
            'import_status', 
            $import_result, 
            get_permalink() // 获取当前页面的URL，避免硬编码
        );
        wp_redirect($redirect_url);
        exit; // 🔴必须加！终止当前请求，确保重定向生效
    } else {
        $import_result = 'no_file';
        wp_redirect(add_query_arg('import_status', $import_result, get_permalink()));
        exit;
    }
}

// 3. 重定向后，根据GET参数显示状态提示
if (isset($_GET['import_status'])) {
    switch ($_GET['import_status']) {
        case 'success':
            echo '<div class="notice notice-success is-dismissible"><p>CSV文件导入成功！</p></div>';
            break;
        case 'no_file':
            echo '<div class="notice notice-error is-dismissible"><p>请选择要上传的CSV文件！</p></div>';
            break;
        // 可以扩展更多错误状态，比如文件格式错误、数据库插入失败等
    }
}
?>

<!-- 表单部分：必须添加WordPress的CSRF令牌 -->
<form method="post" enctype="multipart/form-data">
    <?php wp_nonce_field('csv_import_action', 'import_nonce'); ?>
    <input type="file" name="file" accept=".csv" required />
    <input type="submit" name="submit" value="上传并导入CSV" class="button button-primary" />
</form>

关键细节说明 #

• 用wp_redirect()替代原生header()：这个函数会自动处理WordPress的内部头信息，避免和WP的输出缓冲、钩子逻辑冲突，比原生重定向可靠得多。
• 必须加exit;：如果不终止当前请求，WordPress后续的模板渲染代码会继续执行，导致重定向失效，甚至出现“已发送头信息”的报错。
• CSRF验证不可少：wp_nonce_field()生成的令牌，配合check_admin_referer()验证，既能防止跨站请求伪造，还能过滤掉刷新页面时的重复POST请求（因为刷新时没有有效的令牌）。
• 用GET参数传递状态：重定向后通过import_status参数显示成功/错误提示，用户刷新页面时只会发送GET请求，不会触发重复上传。

如果是在WordPress后台（比如自定义插件页面），建议把导入逻辑放在admin_init钩子或者自定义页面的回调函数里执行，避免请求顺序问题。

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