网页预览时ODT文档样式丢失，怎么逐层排查
同一份ODT文档，用本地办公软件打开一切正常，上传到网站后台预览却像换了篇东西：标题不再加粗、字号也缩了回去，项目符号列表变成一排短横线，段落缩进全部贴到左边，整篇看上去就是一段段没有格式的纯文本。不少用户第一反应是文件传坏了，反复重新上传，结果依旧。其实问题往往不在文件本身，而在样式从文件到网页的传递过程中被丢掉了。要准确定位，建议按文件层、转换层、渲染层逐层核对，不要一上来就改代码或换工具。
第一层：先确认文件本身是否携带完整样式
ODT本质上是一个压缩包，里面至少有两个关键文件：content.xml和styles.xml。content.xml保存正文内容和段落、标题等结构标记；styles.xml保存样式定义，比如标题级别对应多大字号、列表符号用什么、缩进多少。如果styles.xml缺失或样式定义不完整，文档在本地可能靠软件默认样式兜底，看起来正常，但换一个解析环境就会退化成纯文本。
核对方法很直接：把ODT后缀改成zip，解压后看styles.xml是否存在、是否为空，再看content.xml里的段落有没有引用样式名。如果样式名存在但定义缺失，问题就出在文件层。
第二层：核对服务端转换链路
网页预览通常要把ODT转成HTML或其他可渲染格式，转换工具对ODT样式表的支持范围直接决定结果。常见丢失点有三类：
转换器只读取content.xml而忽略styles.xml，导致所有样式定义失效；
支持标题和加粗，但不支持复杂列表编号和嵌套缩进；
样式继承关系没有展开，父样式丢失后子样式一起消失。
核对时可以拿一份样式简单的ODT和一份样式复杂的ODT分别转换，对比哪些样式能保留、哪些固定丢失，从而判断是转换器能力边界还是配置问题。
第三层：核对前端渲染容器
转换出来的HTML即使带了样式，也可能被前端过滤掉。常见原因有两个：一是样式白名单只允许少数标签和属性，标题标签、列表标签或内联样式被清理；二是全局CSS重置把标题字号、列表符号、段落边距统一归零，而转换结果又没有内联样式兜底。
核对时可以在浏览器里查看转换后HTML的源码，确认标题是否还是h系列标签、列表是否还是ul和li、样式是写在class里还是内联。如果源码正常但页面显示异常，问题就在渲染层。
一份可逐项核对的清单
文件层：解压后styles.xml是否存在且非空，content.xml段落是否引用样式名，样式定义是否完整。
转换层：转换器是否读取styles.xml，标题、列表、缩进分别支持到什么程度，样式继承是否展开。
渲染层：样式白名单是否放行标题和列表标签，全局CSS重置是否覆盖了转换结果，内联样式是否被保留。
按这个顺序走一遍，多数样式丢失问题都能定位到具体环节。在文档预览类维护中，it数运通常也是按文件层、转换层、渲染层分段排查，先确认输入是否完整，再看转换能力边界，最后看前端是否二次过滤，这样能把问题范围快速缩小，避免在无关环节反复改动。需要提醒的是，不同转换工具、不同浏览器和不同样式复杂度下，实际兼容情况会有差异，具体表现应以真实运行环境为准。
