PHPMailer嵌入图片失败求助：邮件签名图片无法正常显示

结合你遇到的情况——AddEmbeddedImage返回false、图片始终无法显示，咱们从几个关键方向排查：

1. 优先确认图片文件的路径与存在性 #

AddEmbeddedImage返回false最常见的原因就是找不到目标图片文件。你当前用的是相对路径'test.JPG'，这个路径是相对于PHP脚本的执行目录，很容易出错。

建议换成绝对路径测试，同时先验证文件是否存在：

$imagePath = 'test.JPG';
// 先检查文件是否存在
if (!file_exists($imagePath)) {
    die('错误：找不到图片文件，路径为：' . $imagePath);
}
// 或者用realpath获取实际路径，确认是否正确
echo '图片实际路径：' . realpath($imagePath);

// 再尝试嵌入
if($mail->AddEmbeddedImage(realpath($imagePath), "my-attach", "test.JPG", 'base64', 'image/jpeg')){
    $mail->Body = 'Embedded Image: <img alt="PHPMailer" src="cid:my-attach">';
}else{
    echo '嵌入失败，错误信息：' . $mail->ErrorInfo;
    $mail->Body = 'No Embedded Image';
}

2. 检查文件读取权限 #

即使文件存在，服务器的运行进程（比如Apache/Nginx的用户）可能没有读取该图片的权限：

• Linux环境下，可以执行chmod 644 test.JPG给文件设置可读权限；
• Windows环境下，确保PHP进程所在用户有文件的读取权限。

3. 升级PHPMailer到最新稳定版 #

旧版本的PHPMailer可能存在嵌入附件的兼容问题，建议升级到官方最新的稳定版本，新版本修复了很多已知bug，对嵌入图片的处理更可靠。

4. 正确使用Base64作为临时测试方案 #

你之前尝试Base64显示成字符串，是因为没有正确拼接data URI格式。正确的写法如下（虽然会增大邮件体积，但可以用来测试图片本身是否正常）：

// 读取图片并转Base64
$imageData = base64_encode(file_get_contents('test.JPG'));
// 拼接成data URI格式
$imgSrc = 'data:image/jpeg;base64,' . $imageData;
// 写入邮件正文
$mail->Body = "<h1>Test</h1><p><img src=\"$imgSrc\" alt=\"签名图片\" /></p>";

5. 开启PHPMailer的错误调试 #

PHPMailer自带错误信息输出，一定要利用起来！在调用AddEmbeddedImage或Send()失败后，直接打印$mail->ErrorInfo，它会告诉你具体的失败原因（比如文件不存在、权限不足、MIME类型错误等）：

if (!$mail->Send()) {
    echo '邮件发送失败：' . $mail->ErrorInfo;
}

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