本文详解在 Laravel 中结合 mPDF 生成含图片的 PDF 时，因路径解析错误导致图片无法显示的问题，并提供基于 public_path() 的可靠解决方案。
本文详解在 laravel 中结合 mpdf 生成含图片的 pdf 时，因路径解析错误导致图片无法显示的问题，并提供基于 `public_path()` 的可靠解决方案。
在 Laravel 中使用 mPDF 生成带图片的 PDF 是常见需求，但一个高频陷阱是：直接在 Blade 模板中使用 Web 路径（如 /frontend/assets/images/cv/xxx.jpg）作为 <img src> 的值，会导致 mPDF 渲染失败或显示空白占位符。这是因为 mPDF 在服务端生成 PDF 时，并不通过 HTTP 请求加载图片，而是直接读取本地文件系统路径——它需要的是绝对磁盘路径（filesystem path），而非相对 URL。
✅ 正确做法是：将图片 URL 转换为服务器上的真实物理路径，使用 Laravel 的 public_path() 辅助函数：
<!-- ✅ 正确：传入磁盘绝对路径 --> @@##@@image) }}" alt="Profile Image" />
⚠️ 注意事项：
-
public_path()返回的是public/目录的完整绝对路径（例如/var/www/myapp/public/frontend/assets/images/cv/avatar.png），mPDF 可直接读取； - 确保
$data['seeker']->image值安全（建议校验非空、过滤路径遍历字符如../）； - 图片格式需被 mPDF 支持（推荐 JPG、PNG；避免 WebP 或 SVG，除非启用额外扩展）；
- 若图片存于
storage/app/public/下，需先执行php artisan storage:link并使用storage_path('app/public/...')替代public_path()； - 避免使用
asset()、url()或相对路径（如./images/xxx.jpg），它们返回的是 URL，mPDF 无法解析。
此外，建议在控制器中增强健壮性：
// Controller 示例（含容错）
$imagePath = $data['seeker']->image
? public_path('frontend/assets/images/cv/' . basename($data['seeker']->image))
: public_path('frontend/assets/images/cv/default.png');
if (!file_exists($imagePath)) {
$imagePath = public_path('frontend/assets/images/cv/default.png');
}
$view = view('frontend.create-cv.pdf', compact('data', 'imagePath'));
$mpdf = new \Mpdf\Mpdf([
'mode' => 'UTF-8',
'format' => [400, 400],
'autoScriptToLang' => true,
'autoLangToFont' => true,
]);
$mpdf->WriteHTML($view->render());
return response($mpdf->Output('', 'S'))
->header('Content-Type', 'application/pdf')
->header('Content-Disposition', 'inline; filename="cv.pdf"');
总结：mPDF 不是浏览器，它不理解 HTTP 协议，只认文件系统路径。始终用 public_path()（或 storage_path()）显式提供图片的绝对路径，是确保 PDF 图片正常渲染的关键实践。
