PHP 8.1下mail()失败主因是环境配置问题：函数被禁用、MTA未安装/未启用、25端口被云厂商封锁或邮件头格式错误；应优先检测function_exists('mail')、MTA状态及telnet localhost 25连通性，无效则改用PHPMailer并启用SMTPDebug=2调试。
PHP 8.1 环境下邮件发送失败常表现为无报错、无提示、收件方收不到，但实际是底层配置或兼容性问题在静默拦截——不是代码写错了，而是环境卡住了。
确认 mail() 函数是否可用
第一步：新建 test-mail.php，写入 var_dump(function_exists('mail')); 并访问。返回 bool(false) 表示函数被禁用，需检查 php.ini 中 disable_functions 是否含 mail。
第二步：若函数存在但调用返回 false，立即执行 systemctl status sendmail 或 systemctl status postfix。Linux 服务器若未安装或未启用 MTA，【mail() 必然失败，任何 PHP 层修改都无效】。
第三步：在共享主机或 Docker 容器中，多数环境根本没装 sendmail。此时不要挣扎，直接跳转到「改用 PHPMailer」环节。
立即学习“PHP免费学习笔记（深入）”；
检查邮件头格式与换行符
方法一：用 \r\n 严格拼接 headers
必须用 "\r\n"（不能是 "\n" 或 "\r"），且末尾不能多空行。错误示例：$headers = "From: a@b.com\r\n\r\n"; —— 多出的 \r\n 会让整个邮件头解析失败，mail() 静默返回 false。
方法二：中文主题必须 base64 编码
若 $subject 含中文，不处理会直接丢弃。正确写法：$subject = '=?UTF-8?B?'.base64_encode('订单通知').'?=';。漏掉这步，Gmail 和 Outlook 基本拒收。
验证 SMTP 外发能力
运行命令：telnet localhost 25。连接失败说明本地无 SMTP 服务；若提示 Connection refused，证明 sendmail/postfix 没启动，或端口被防火墙屏蔽。
云服务器（如阿里云、腾讯云）默认封禁 25 端口。此时即使本地 MTA 正常，【mail() 仍会失败，且不报错】。必须改用 465/587 端口 + SMTP 认证方式，也就是换 PHPMailer。
检查 cPanel/Plesk 面板里的“出站邮件限制”是否开启——很多主机商默认启用，禁止脚本外发邮件，仅允许通过其 SMTP 中继。
启用错误报告并捕获返回值
在调用 mail() 前加两行：
error_reporting(E_ALL);
ini_set('display_errors', 1);
然后用 if (!mail(...)) { echo '失败'; } 显式判断。注意：mail() 只返回 true/false，不抛异常，不输出错误详情，不设断点就永远不知道哪一步挂了。
这一步做完，如果 still false，说明问题不在 PHP 语法，而在系统层或网络层——回头重查 MTA 状态和端口连通性。
改用 PHPMailer（推荐方案）
第一步：用 Composer 安装：composer require phpmailer/phpmailer。
第二步：初始化时强制启用调试模式：
$mail->SMTPDebug = 2; —— 这会把完整 SMTP 交互日志输出到页面，比看错误日志快十倍。
第三步：关键配置必须显式声明：
$mail->isSMTP();
$mail->Host = 'smtp.qq.com';
$mail->Port = 465;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->SMTPAuth = true;
$mail->Username = 'your@qq.com';
$mail->Password = 'your_app_password'; —— 注意：QQ 邮箱必须用“SMTP专用密码”，不是登录密码。
第四步：设置 From 地址必须与 Username 一致，否则多数 SMTP 服务器直接拒绝。
