很多团队在Polarion里写LiveDoc与交付文档，真正出问题往往发生在导出那一刻：模板没统一、资源路径不可访问、图片格式不兼容，结果就是版式不一致或图片被占位图替换。下面按先把文档生成配置做稳，再把图片丢失按来源逐类修复的思路，把常见卡点一次讲清楚。

　　一、Polarion文档生成怎么配置

　　文档生成配置的核心不是做出一份能导出的PDF，而是让所有人用同一套入口与模板导出同一口径的交付件，这样评审与签核才不会反复返工。

　　1、先统一导出入口与导出格式

　　打开目标LiveDoc或页面后，从右上角找到【Export】，优先选【PDF】用于冻结版式，确实需要外部人员回填再导回Polarion时再选【Word Round-trip】；把这条规则写进团队交付规范，避免有人用截图或浏览器打印替代导出导致版式失真。

　　2、在项目管理端把PDF导出配置集中管理

　　进入项目右上角【Actions】后打开【Administration】，在左侧导航里找到【PDF Export】并进入，在这里把模板、样式与相关选项集中放到一处管理，后续用户导出时就不必每次临时选一堆参数。

　　3、把样式改动落到pdf.css并建立可回滚版本

　　如果你们遇到标题层级、列表缩进、表格边框在PDF里不符合规范，不要靠手动改内容凑版式，优先在服务器侧的pdf.css里调整样式，并把改动按日期留档，做到能回滚；常见做法是先复制一份当前pdf.css，再小步修改并立刻导出验证。

　　4、把页眉页脚封面元素当成模板资产来管

　　页眉Logo、封面背景、页脚编号这类内容不要从外部链接引用，尽量作为模板资产随PDF导出配置一起维护；改动时先在测试文档导出一份校验件，确认页眉页脚显示正常再推广到全员使用。

　　5、给使用者留出可控的可变项

　　在模板里固定不该变的部分，例如页眉页脚、字体、目录样式、表格跨页规则；把允许变化的部分留在导出弹窗里，例如是否包含评论、是否包含某些章节，减少因为个体习惯导致的导出差异。

　　二、Polarion文档生成时图片丢失怎么修复

　　图片丢失通常不是随机故障，而是图片在导出引擎看来不可访问、不可解析或缺少导出兜底资源。修复时先判定是哪一类，再对症处理。

　　1、先确认是否出现不可访问占位图

　　导出PDF后如果看到占位图提示图片不可访问，基本可以直接判断为资源访问问题，而不是内容没插对位置；这类报错在导出失败信息里也常会写明有图片未导出并被替换为不可访问占位图。

　　2、把外链图片改为附件插入并重新保存

　　回到LiveDoc编辑页，逐张检查图片来源，凡是通过外部URL粘贴进来的，建议删掉后用编辑器的【Insert Image】走【Upload】上传为附件再插入，确保导出过程不依赖外部网络与额外鉴权；插入后点击【Save】再重新导出验证。

　　3、遇到SVG丢失先补同名PNG作为导出兜底

　　如果文档里用了SVG矢量图，导出PDF或Word时可能会丢图或显示异常，官方明确的修复方式是为每个SVG再附上一张同名PNG，导出时用PNG保证可输出；操作上就是把PNG文件名与SVG保持完全一致，只是扩展名不同，然后重新导出检查。

　　4、模板页眉图片丢失优先排查模板引用路径是否可被导出引擎访问

　　如果丢失的主要是页眉Logo或封面图，而正文图片正常，重点回到【Administration】里的【PDF Export】查看模板对图片的引用方式，常见问题是图片虽在版本库里但导出引擎按当前权限或路径规则拿不到，结果被判定为不可访问并替换成占位图；修复思路是把图片作为导出配置可直接读取的资产来引用，改完后用同一文档重复导出确认不再报不可访问。

　　5、只丢少数图片时按格式与文件名做快速筛查

　　当现象是某几张图丢、其余正常，优先检查这几张是否是少见格式或从历史资料复制过来导致元信息异常；处理时先把原图转成PNG或JPG，再用【Insert Image】重新上传插入，避免导出引擎对冷门格式解析失败造成静默丢图。

　　三、Polarion文档生成图片丢失自检流程

　　把修复做完还不够，真正省时的是把自检固化成步骤，让图片问题在交付前被提前发现，而不是到签核节点才临时救火。

　　1、先做一份标准自检文档

　　准备一份包含封面、页眉页脚、目录、表格、常见图片类型的标准LiveDoc，作为每次改模板与改样式后的回归样例，任何改动先导出这份样例，确认通过再放到真实交付文档上。

　　2、导出前先用页面快速巡检定位高风险图片

　　在LiveDoc里从头到尾快速滚动一遍，重点看页眉Logo、封面图、流程图、矢量图与大尺寸截图，发现来源不明或疑似外链的图片就先替换为附件插入，避免导出后再逐页翻找。

　　3、导出后用两次对照法确认是否真丢图

　　第一次导出用【PDF】看版式与图片是否完整，第二次导出用【Word Round-trip】看是否存在导出引擎差异导致的缺失；两次对照能快速判断是内容侧问题还是模板侧问题。

　　4、把常见错误收口到一张处理单

　　把不可访问占位图、SVG缺PNG、页眉图片路径不可读、少数图片格式异常这几类问题写成内部处理单，明确谁负责改模板、谁负责改文档内容、谁负责服务器侧样式，下一次遇到同类问题就能按单执行而不是临时猜原因。

　　总结

　　Polarion文档生成配置要稳定，关键是把【Administration】里的【PDF Export】当成统一出口来管理模板与样式，并用可回滚的方式维护pdf.css；图片丢失修复要快，关键是先判定是否不可访问占位图，再把外链改附件、SVG补同名PNG、模板页眉图改成导出引擎可读资产，最后用自检样例把问题前置拦截。