PHP mail()函数发送失败需按五步排查：一查函数是否启用及MTA服务状态；二验邮件头格式与参数合法性；三确认SMTP外发限制；四启用错误报告捕获返回值；五用PHPMailer等替代方案交叉验证。
如果在使用PHP的mail()函数发送邮件时总是失败，则可能是由于服务器配置、函数参数或环境限制等问题导致。以下是排查此问题的具体方法：
一、检查PHP mail()函数是否启用
PHP的mail()函数依赖于服务器的本地邮件传输代理（MTA），如sendmail或Postfix。若服务器未安装或禁用了MTA，mail()将无法调用底层发送机制。
1、创建一个PHP文件，写入var_dump(function_exists('mail'));并运行。
2、若返回bool(false)，说明mail()函数被禁用，需检查php.ini中disable_functions配置项是否包含mail。
立即学习“PHP免费学习笔记（深入）”；
3、若函数存在但返回false，继续检查系统级MTA服务状态，例如在Linux中执行systemctl status sendmail或systemctl status postfix。
二、验证邮件头格式与参数合法性
mail()函数对邮件头格式极为敏感，任意非法换行、缺失必要字段或编码错误都会导致静默失败。
1、确保$to参数为单个合法邮箱地址，不含中文、空格或多个地址拼接。
2、检查$headers参数中是否包含From:字段，且其值符合RFC 2822规范，例如"From: webmaster@example.com"。
3、避免在$headers中使用\r\n以外的换行符；禁止在字符串末尾添加多余空行或制表符。
4、若需支持UTF-8中文主题或正文，必须手动设置Content-Type和Content-Transfer-Encoding头，并对中文内容进行base64_encode处理。
三、确认服务器SMTP外发限制
多数共享主机或云服务器默认屏蔽25端口外发，且不提供本地MTA服务，导致mail()调用直接被系统拒绝。
1、使用telnet localhost 25测试本地SMTP端口是否可连接。
中文 Word 文档自动化校对工具。当用户需要对中文文本或 Word 文档进行标点符号检查、语法检查、错别字检查时使用此 skill。触发词：语法检查、错别字、标点符号、校对、检查文档。
2、若连接失败，说明无可用MTA；此时mail()必然失败，不可仅靠修改PHP代码修复。
3、检查防火墙规则（如ufw或iptables）是否拦截了sendmail/postfix进程的网络行为。
4、在cPanel或Plesk等面板中确认“邮件限制”或“出站邮件阻止”功能是否开启，部分服务商默认启用该策略以防止垃圾邮件。
四、启用错误报告并捕获返回值
mail()函数本身不抛出异常，仅返回布尔值，且错误信息默认不输出，需主动开启调试机制才能定位根本原因。
1、在调用mail()前添加error_reporting(E_ALL); ini_set('display_errors', 1);。
2、将mail()调用结果赋值给变量，例如$result = mail($to, $subject, $message, $headers);。
3、立即检查if (!$result) { error_log("mail() returned false"); }，并将日志路径设为可写位置。
4、查看PHP错误日志（由error_log指令指定）及系统maillog（如/var/log/mail.log）中对应时间点的记录。
五、切换至替代方案验证是否为函数局限
mail()函数不具备身份认证、SSL/TLS加密、SMTP会话跟踪等能力，许多现代邮件服务（如Gmail、Outlook）已拒绝接收其发出的邮件，需改用更可靠的库进行交叉验证。
1、下载PHPMailer源码并引入项目，使用SMTP方式连接smtp.gmail.com:587，启用TLS和App Password认证。
2、使用PHPMailer的$mail->SMTPDebug = 2开启调试模式，观察完整通信流程与错误响应码。
3、若PHPMailer能成功发送而mail()失败，则确认为mail()函数自身限制所致，而非应用逻辑错误。
4、若PHPMailer同样失败，重点检查DNS解析（如nslookup smtp.gmail.com）、网络连通性（如curl -v smtps://smtp.gmail.com:587）及账户权限设置。
