不少负责文档预览功能的团队，都收到过这样的用户反馈：上传一份DOCX文件后，在浏览器里打开，正文显示得好好的，可页眉里的公司名称、页脚里的页码却怎么都找不到。有些用户第一反应是文件坏了，于是重新上传一遍，结果还是一样。真正排查下去就会发现，这类情况通常不是某一个单独原因造成的，而是文档结构、转换链路、渲染容器三个层面共同作用的结果。先要把三种表现区分开：第一种是页眉页脚彻底不见，页面上一点痕迹都没有；第二种是位置发生偏移，内容跑到了正文区域或者页面边缘以外；第三种是内容被截断，只露出一部分文字或线条。这三种现象对应的排查方向并不一样，如果混在一起查，很容易绕远路。
第一层需要核对文档结构本身。DOCX里的页眉页脚并不是直接挂在段落上的，而是通过节属性中的引用关系，关联到具体的页眉页脚部件。如果转换程序只读取了主文档流，把这些引用忽略掉，页眉页脚自然就不会被输出。另外还要留意分节符，一份文档可能包含多个节，每个节都可以有不同的页眉页脚设置，包括首页不同、奇偶页不同。如果转换时只取了第一节的配置，后面几节的页眉页脚就会丢失。核对的方法是先把原文件解压，查看文档部件中是否存在对应的页眉页脚文件，以及节属性里是否保留了引用关系。
第二层需要核对服务端转换链路。很多预览方案依赖服务端把DOCX转成HTML或图片，而不同转换工具对页眉页脚的处理差异很大。有的工具默认不输出页眉页脚，需要在参数里显式开启；有的虽然会输出，但对距边界值、页眉页脚高度的计算方式不同，结果内容被挤到可视区域之外。首页不同的设置也容易被忽略，转换后首页页眉页脚可能被统一套用到所有页面，或者反过来全部丢弃。这一层的关键，是确认转换参数是否完整传递了原始文档的页面设置，而不是只看转换有没有成功。
第三层需要核对CSS与容器渲染。就算转换结果里已经包含了页眉页脚内容，预览容器也可能把它裁掉。常见的情况是容器设置了固定高度配合溢出隐藏，页眉页脚正好落在被裁掉的区域里。另一种是打印样式覆盖，某些预览组件在屏幕显示时应用了打印媒体查询，而打印样式里对页眉页脚做了隐藏处理。还有绝对定位的页眉页脚，在容器尺寸变化后偏离了原位，看起来就像是消失了。核对时可以先在浏览器开发者工具中查看转换后的DOM结构，确认页眉页脚节点是否存在，再检查容器的溢出和定位设置。
可以按四个维度整理一份排查清单。文档结构维度：确认页眉页脚部件存在、节引用关系完整、多节配置没有被合并。转换参数维度：确认转换工具已开启页眉页脚输出、边距和距边界值按原文档传递、首页不同设置被正确处理。渲染容器维度：确认容器没有溢出裁剪、没有固定高度限制、没有打印样式覆盖。浏览器差异维度：在不同内核浏览器中对比同一文件的预览效果，排除单一环境下的渲染偏差。
处理顺序上，建议先保留用户上传的原始文件，用同一文件在本地和线上分别复现，确认问题出在转换前还是转换后。如果短时间内无法修复转换链路，可以先提供原文件下载入口作为降级方案，避免用户完全无法获取页眉页脚信息。it数运在网站维护实践中，通常把这类问题归入文档预览兼容性核对，按结构、转换、渲染的顺序逐层定位。具体实现方式应以项目实际使用的技术栈和转换工具为准，必要时咨询相关专业人士。
