图片没出来,问题分两类落在两个地方:一类是页面加载还没走完,图片没轮到绘制,产物里就是空位;另一类是图片资源挂在统计与广告域名上,被屏蔽掉拿不到。先在浏览器里打开那个网址看图片正不正常,再决定重跑、换「URL截图」出整页,还是把关键图单独存下来走「图片转PDF」。
一、先分清「没截到」还是「没下发」
判断只看一件事:本机浏览器打开同一个网址,图片正常显示吗?显示正常,说明资源本身能拿到,缺图发生在服务器渲染的时机上;本机也刷不出来,那是页面自己的资源问题,站里怎么跑都不会多出图片来。
二、三类常见原因对照
| 原因 | 现场表现 | 自查办法 | 走法 |
|---|---|---|---|
| 加载没走完 | 文字齐、图片位是灰块 | 本机要多等一会才出图 | 重跑或换时段,窗口到点先出已渲染部分 |
| 统计与广告资源被屏蔽 | 特定横幅图、埋点图缺失 | 本机打开也被拦截工具挡掉 | 关键图存本地单独转 |
| 折叠线下方懒加载 | 首屏图正常、往下翻的图缺 | 本机慢慢滚到底图才出现 | 确认加载完成后再提交一次 |
三类里只有前两类的结论是稳的:懒加载的表现受页面实现影响,先在本机确认滚到底后图片是否全部出现,再决定要不要重跑。
三、要让 PDF 里带齐图片的步骤
- 本机浏览器打开网址,慢慢滚到底,确认全部图片出得来。
- 提交 网页转PDF 跑一轮,对照产物和图片数量。
- 缺图就先验证渲染进度:用 URL截图 出一张按页面实际高度的整页 PNG,图在截图里有没有,一眼能对上。
- 截图里也缺的,基本是资源侧的问题,把缺的那几张关键图在本机单独保存。
- 存下来的图传 图片转PDF,每张图占一页,页面尺寸按图片自身来,补进交付文件。
四、别做这几件事
- 别连着提交同一网址赌某一次全出来:加载窗口每次都是同样的规则,慢页面要换时段再试,不是多按几次。
- 别指望转出来的图比原图更清楚:渲染不补像素,图片精细度由网站原图决定,转换只做搬运。
- 别把要登录才见得到图的页面交进来:带验证码、内网地址的页面本来就不在这一档的处理范围。
- 别拿图片缺位当整页失败:正文还在,可以先交付文字部分,图片按第三节补。
常见问题
问:我本机明明能看到全部图片,为什么转出来就缺?
答:本机可能命中了缓存,服务器一侧是重新拉取页面;慢资源在加载窗口到点前没完成,就先出已渲染部分,以产物和整页截图的实际结果为准。
问:加载窗口到底等多久?
答:页面加载满 30 秒未结束也会先把已经渲染出来的部分出图,这是站内固定参数;所以图多的慢页面更常见的是「出来一半」。
问:「图片转PDF」出来的图会被压小吗?
答:不会缩放像素,页面尺寸按图片自身来、每张图占一页,这一档没有「统一成 A4」的开关;要 A4 得先把图改成对应比例。
问:手机上能完成这套排查吗?
答:能,站内入口都是网页,手机浏览器打开就能截图、转 PDF;只有「本机保存关键图」「滚动核对加载」这两步在你自己的浏览器里做。
本站入口
站内 网页转PDF,输入公开网址出一个 A4 竖版 PDF,渲染与出图都在本站服务器一侧完成;不登录也能用,登录后产物在文件列表里集中取。
补图链路记住两步:整页验证走「URL截图」,单独的关键图走「图片转PDF」,缺哪张补哪张。