WordPress Elementor HTML表单提交发邮件报错解决方案

你碰到的Failed to open stream: No such file or directory报错，核心原因是表单配置的提交路径和send-email.php实际存放路径不匹配。另外不建议在WordPress目录下放置独立PHP文件处理表单请求：这类文件不会自动加载WordPress核心运行环境，容易出现权限拦截、安全校验失效、函数调用报错等问题，就算修正路径让文件能被访问，后续也大概率碰到其他故障。
以下是三个经过验证的可落地方案，按实现成本从低到高排列： #

方案1：使用Elementor原生表单模块（零代码，最省事） #

• 不需要自己用HTML Snippets手写表单，Elementor自带的表单组件（免费版/Pro版均支持）直接拖入页面即可使用
• 在表单的「提交后操作」配置项中直接勾选「发送邮件」，按提示填写收件邮箱、发件人标识、邮件正文模板即可，系统自动完成字段校验、防垃圾提交、路径适配，不会出现文件找不到类的错误
• 需要新增自定义字段时，直接在组件的字段管理面板添加即可，提交的内容会自动同步到邮件正文中

方案2：对接WordPress原生AJAX接口（适配你已写好的自定义HTML表单） #

如果你已经写完HTML表单不想重构，直接放弃独立PHP处理文件，对接WordPress官方提供的AJAX处理接口即可，步骤如下：

1. 修改你放在HTML Snippets里的表单代码，移除原有action属性，添加表单ID和必要的隐藏字段：

<form id="custom_contact_form">
  <!-- 保留你原有的所有表单字段，示例如下 -->
  <input type="text" name="user_name" placeholder="姓名" required>
  <input type="email" name="user_email" placeholder="联系邮箱" required>
  <textarea name="message" placeholder="留言内容" required></textarea>
  <!-- 必须加的隐藏字段，标记要触发的处理动作 -->
  <input type="hidden" name="action" value="send_custom_form_email">
  <button type="submit">提交留言</button>
</form>

2. 由于Elementor的HTML Snippets组件默认不解析PHP代码，先把下面的代码添加到当前子主题的functions.php文件中（不要直接改父主题，否则主题更新时代码会被覆盖），全局输出AJAX接口地址：

add_action('wp_head', 'output_global_ajax_config');
function output_global_ajax_config() {
    echo '<script>window.ajaxUrl = "'.admin_url('admin-ajax.php').'";</script>';
}

3. 继续在functions.php中添加邮件发送的处理逻辑，使用WordPress自带的wp_mail函数发信，兼容性远高于原生mail函数：

// 同时支持登录用户、未登录游客提交表单
add_action('wp_ajax_send_custom_form_email', 'process_custom_form_submit');
add_action('wp_ajax_nopriv_send_custom_form_email', 'process_custom_form_submit');
function process_custom_form_submit() {
    // 基础参数校验
    if (empty($_POST['user_name']) || empty($_POST['user_email']) || empty($_POST['message'])) {
        wp_send_json_error('请填写所有必填项');
    }
    if (!is_email($_POST['user_email'])) {
        wp_send_json_error('请填写有效的联系邮箱');
    }

    // 组装邮件内容，所有用户输入必须做安全过滤，防止注入攻击
    $to = get_option('admin_email'); // 默认发送到站点管理员邮箱，可自行修改
    $subject = '站点联系表单收到新留言';
    $body = "提交人：".sanitize_text_field($_POST['user_name'])."<br>";
    $body .= "联系邮箱：".sanitize_email($_POST['user_email'])."<br>";
    $body .= "留言内容：<br>".nl2br(sanitize_textarea_field($_POST['message']));
    $headers = [
        'Content-Type: text/html; charset=UTF-8',
        'From: 站点通知 <no-reply@'.$_SERVER['HTTP_HOST'].'>'
    ];

    $send_result = wp_mail($to, $subject, $body, $headers);
    if ($send_result) {
        wp_send_json_success('留言提交成功，我们会尽快回复');
    } else {
        wp_send_json_error('提交失败，请稍后重试');
    }
    wp_die();
}

4. 在HTML Snippets的表单代码下方添加一小段JS，实现无刷新提交：

const contactForm = document.getElementById('custom_contact_form');
contactForm.addEventListener('submit', function(e) {
    e.preventDefault();
    const formData = new FormData(contactForm);
    fetch(window.ajaxUrl, {
        method: 'POST',
        body: formData
    })
    .then(res => res.json())
    .then(res => {
        alert(res.data);
        if (res.success) contactForm.reset();
    })
    .catch(() => alert('网络异常，请稍后重试'));
});

*如果后续碰到邮件收不到的问题，直接安装SMTP类插件配置第三方发信服务即可，不需要修改上述业务代码。 #

方案3：使用第三方表单插件（零代码，扩展性强） #

如果不想写任何代码，可以直接安装免费的表单插件实现需求：

• 可选插件包括Contact Form 7、WPForms等，安装后在可视化界面配置表单字段、收信规则
• 配置完成后插件会自动生成短代码，把短代码粘贴到Elementor的短代码组件中即可正常使用
• 这类插件已经内置了防垃圾提交、字段校验、SMTP适配、提交记录留存等能力，不需要额外调试路径、文件权限问题

内容的提问来源于stack exchange，提问作者Carlos Gomes