如何在Contact Form 7中设置动态收件人？提交时遇发送错误

我之前也碰到过一模一样的情况，主邮件用静态收件人完全正常，但用post_meta动态设置邮件2收件人就弹出红色错误提示。结合CF7的运行机制，给你几个排查和解决的方向：

1. 先确认自定义字段的正确性 #

这是最容易踩坑的环节：

• 确保你页面的自定义字段键名完全是targetemail（大小写敏感！），如果你的字段是TargetEmail或者target_email，CF7的default:post_meta会找不到对应值，导致收件人为空，直接触发发送错误。
• 可以临时在页面模板里加一行代码测试字段值：

  echo get_post_meta(get_the_ID(), 'targetemail', true);
  

  打开页面看看有没有输出正确的邮箱地址，先排除字段本身没有内容的问题。

2. 优化CF7的表单和邮件设置 #

• 把表单里的短代码改成更明确的写法，避免自动匹配出错：

  [email* targetemail default:post_meta key:targetemail]
  

  这里的key:targetemail强制指定读取的自定义字段键名，比默认的自动匹配更可靠。
• 在邮件2的「收件人」栏，建议添加一个备用收件人，比如：

  [targetemail], your-backup@example.com
  

  这样如果动态值为空，邮件还能发送到备用地址，方便你排查问题。
• 暂时把邮件2的「邮件类型」改成纯文本，排除HTML格式带来的隐藏问题。

3. 绕过CF7的收件人验证机制 #

CF7默认会验证收件人是否属于你的站点域名，或者在允许的收件人列表里。如果你的动态收件人是外部邮箱，很可能被拦截。可以用钩子直接控制邮件2的收件人：

把下面的代码添加到你的主题functions.php文件，或者自定义插件里：

add_action('wpcf7_before_send_mail', 'cf7_set_dynamic_mail2_recipient');
function cf7_set_dynamic_mail2_recipient($contact_form) {
    // 替换成你的表单ID，在CF7编辑页面的URL里能看到
    if ($contact_form->id() !== 123) return;

    $submission = WPCF7_Submission::get_instance();
    if (!$submission) return;

    // 获取当前页面的自定义字段值
    $current_post_id = get_the_ID();
    $target_email = get_post_meta($current_post_id, 'targetemail', true);

    // 如果获取到有效邮箱，设置邮件2的收件人
    if (!empty($target_email) && is_email($target_email)) {
        $mail2_settings = $contact_form->prop('mail_2');
        $mail2_settings['recipient'] = $target_email;
        $contact_form->set_prop('mail_2', $mail2_settings);
    }
}

这个方法直接在邮件发送前修改邮件2的收件人，绕过了表单短代码的验证环节，成功率很高。

4. 开启调试模式定位错误 #

在wp-config.php里添加以下代码，开启WordPress调试：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

提交表单后，查看wp-content/debug.log文件，里面会有具体的错误提示，比如「Invalid recipient」（收件人无效）或者「Post meta not found」（找不到自定义字段），能帮你精准定位问题。

5. 排查SMTP服务商限制 #

虽然主邮件能正常发送，但有些SMTP服务商（比如SendGrid、Gmail）会限制动态收件人，或者要求收件人在验证列表里。你可以临时把动态收件人换成你自己的邮箱测试，如果能发送，说明是服务商的限制，需要去SMTP后台添加允许的收件人或者调整设置。

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