ACF前端表单重复提交问题排查求助

我在后端使用ACF的经验较为丰富，但刚接触前端ACF表单，目前使用全新WordPress测试环境。表单可正常运行，但每次提交都会生成两条重复记录，找不到导致重复提交的原因，相关代码如下：

<?php
// Show ACF Form On Front End Via ShortCode

// Code to show form
add_action('init', 'brandpage_form_head');
function brandpage_form_head() {
    acf_form_head();
}

// Function for the shortcode
function bwp_acf_form_function($attr) {

    // If ACF isn't running then exit
    if (!function_exists('acf_form')) {
        return;
    }

    // Buffer data instead of outputting it
    ob_start();

    // Unique form ID to avoid conflicts
    $form_id = 'bwp-acf-form-' . uniqid();

    // Debug: Log form ID and request data
    error_log('Rendering ACF Form with ID: ' . $form_id);
    error_log('Request data: ' . print_r($_REQUEST, true));

    // Display ACF form
    acf_form(array(
        'id'               => $form_id,
        'post_id'          => 'new_post',
        'new_post'         => array(
            'post_type'   => 'daily-message',
            'post_status' => 'draft',
        ),
        'field_groups'     => array($attr['field_group_id']),
        'post_title'       => false, // False to auto-populate
        'post_content'     => false, // False to not use for content
        'submit_value'     => __("Update", 'acf'),
        'updated_message'  => __("Daily Messenger Post Added", 'acf'),
        'return'           => '', // Redirect URL after saving (empty string means no redirect)
        'html_after_fields'=> '<input type="hidden" name="my_form_nonce" value="' . wp_create_nonce('my_form_nonce_action') . '">', // Add nonce for security
    ));

    // Empty the buffer data
    return ob_get_clean();
}

// Add the shortcode
add_shortcode('bwp_acf_form', 'bwp_acf_form_function');

?>

可能的原因及解决方向 #

• acf_form_head() 重复执行：你把acf_form_head()挂在了init钩子上，但如果主题的header.php里已经调用过这个函数，或者其他插件也加载了ACF表单初始化逻辑，就会导致表单处理代码被触发两次。检查：

  • 主题模板里是否存在重复的acf_form_head()调用
  • 禁用其他插件，测试是否还会出现重复提交
  • 页面中是否多次插入了[bwp_acf_form]短代码

• 无重定向引发的重复提交：你设置了'return' => ''，表单提交后页面不会跳转，用户刷新页面时浏览器会重新发送提交请求，生成第二条记录。建议设置明确的重定向URL，比如：

  'return' => get_permalink(), // 提交后返回当前页面
  

• init钩子被重复触发：部分本地测试环境（比如某些WAMP/LAMP配置）可能会导致init钩子执行两次。在brandpage_form_head函数里添加日志排查：

  function brandpage_form_head() {
      error_log('acf_form_head executed at: ' . current_time('mysql'));
      acf_form_head();
  }
  

  查看WordPress的错误日志，如果有两条时间接近的记录，说明钩子被重复触发。

• 自定义nonce的干扰：ACF本身自带了nonce验证，你额外添加的自定义nonce如果没有对应的验证逻辑，不仅起不到额外安全作用，还可能因冲突导致ACF的默认验证失效。暂时移除html_after_fields里的自定义nonce代码，测试是否解决问题。

• 短代码重复渲染：检查页面最终的HTML源码，看是否生成了两个相同的表单。如果是，说明短代码被解析了两次，可能是主题模板或页面编辑器里重复调用了短代码。

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