本文详解在 Laravel 中集成 mPDF 生成 PDF 时正确嵌入图片的方法，重点解决因路径解析错误导致的图片加载失败问题，并提供基于 public_path() 的可靠解决方案。
本文详解在 laravel 中集成 mpdf 生成 pdf 时正确嵌入图片的方法，重点解决因路径解析错误导致的图片加载失败问题，并提供基于 `public_path()` 的可靠解决方案。
在 Laravel 中使用 mPDF 生成含图片的 PDF 是常见需求，但许多开发者会遇到图片无法显示的问题——例如 <img src="/frontend/assets/images/cv/xxx.jpg"> 在浏览器中正常，却在 PDF 中显示为占位符或报错。根本原因在于：mPDF 渲染 PDF 时运行于服务端，不通过 HTTP 请求解析相对 URL，而是直接读取本地文件系统；因此必须提供绝对磁盘路径（而非 Web 可访问的 URL）。
✅ 正确做法是：在 Blade 模板中使用 public_path() 辅助函数，将 Web 路径转换为服务器上的真实文件路径：
<!-- ✅ 正确：传入绝对文件系统路径 -->
@@##@@image) }}"
alt="Profile Image"
width="120" height="120">
⚠️ 注意事项：
-
public_path()返回的是类似/var/www/html/public/...的完整物理路径，mPDF 可直接读取； - 确保图片实际存在于
public/frontend/assets/images/cv/目录下，且文件名严格匹配（含扩展名）； - 若图片路径含空格或特殊字符，建议使用
urlencode()包裹（但通常public_path()已兼容）； - 避免使用
asset()、url()或相对路径（如./images/xxx.jpg），它们返回的是 URL，mPDF 无法解析； - 推荐为图片添加
width/height属性，避免 mPDF 因无法获取尺寸而缩放异常。
此外，在控制器中建议增强健壮性，例如校验图片是否存在：
// Controller 示例（增强版）
$imagePath = public_path('frontend/assets/images/cv/' . $data['seeker']->image);
if (!file_exists($imagePath)) {
Log::warning("CV image not found: {$imagePath}");
// 可设置默认占位图路径
$data['seeker']->image = 'placeholder.png';
}
$mpdf = new \Mpdf\Mpdf([
'mode' => 'UTF-8',
'format' => [400, 400],
'autoScriptToLang' => true,
'autoLangToFont' => true,
]);
$mpdf->WriteHTML(view('frontend.create-cv.pdf', compact('data'))->render());
return response($mpdf->Output('', 'S'))
->header('Content-Type', 'application/pdf')
->header('Content-Disposition', 'inline; filename="cv.pdf"');
最后提醒：mPDF 对 PNG/JPEG 支持良好，但对 SVG、WebP 等格式支持有限（尤其旧版本），生产环境请统一使用 JPG 或 PNG 格式，并确保 GD 或 Imagick 扩展已启用。通过以上调整，即可稳定输出含数据库图片的高质量 PDF。
