本地Docker环境WordPress多站点wp_mail无法发送邮件至Mailtrap

你遇到的情况是WP Mail SMTP测试邮件正常，但自定义调用wp_mail时报错Could not instantiate mail function，结合Docker多站点环境，可能的原因和解决办法如下：

1. 多站点插件激活范围不对 #

WP Mail SMTP如果只在主站点激活，子站点默认不会继承插件的邮件配置，此时子站点调用wp_mail会 fallback到PHP原生的mail()函数，而Docker的WordPress镜像通常没预装sendmail、postfix这类邮件组件，直接触发报错。

解决办法：

• 进入WordPress多站点的「网络管理」后台，找到「插件」页面，将WP Mail SMTP设置为「网络激活」，确保所有站点都使用该插件的SMTP发送机制。

2. WP Mail SMTP未正确接管wp_mail #

可能插件的邮件发送方式仍设置为默认的PHP mail()，导致测试邮件走了插件的SMTP，但实际调用wp_mail时还是用原生函数。

解决办法：

• 打开WP Mail SMTP的设置页面，确认「邮件发送方式」选择的是「SMTP」而非「PHP mail()」；
• 再次核对Mailtrap的SMTP主机、端口（通常是2525）、用户名、密码是否正确保存，注意密码不要复制遗漏。

3. 自定义代码调用时机过早 #

如果你的代码在WP初始化完成前调用wp_mail，此时WP Mail SMTP的钩子还未生效，会直接使用原生mail()函数。

解决办法：
把调用wp_mail的代码放到WordPress的钩子中，确保插件已完成初始化，比如用wp_loaded或init钩子：

add_action('wp_loaded', function() {
    $to = 'your-test-email@mailtrap.io'; // 替换为你的测试邮箱
    $subject = 'Welcome to our Website';
    $message = 'Dear User, welcome to our website!';
    $result = wp_mail($to, $subject, $message);
    // 调试用：打印执行结果
    var_dump($result);
});

4. 主题/其他插件冲突 #

部分主题或插件会重写wp_mail函数，绕过WP Mail SMTP的处理逻辑。

解决办法：

• 临时切换到WordPress默认主题（比如Twenty Twenty-Four），再测试wp_mail是否正常；
• 禁用所有其他插件，逐步重新启用，排查出冲突的插件。

5. 调试补充：查看详细错误信息 #

添加钩子捕获wp_mail的错误日志，方便定位具体问题：

add_action('wp_mail_failed', function($wp_error) {
    error_log('WP Mail Error Details: ' . print_r($wp_error, true));
});

然后查看Docker容器日志（docker logs <wp-container-name>）或WordPress的debug.log文件，获取更详细的错误内容。

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