异常表格导致导出docx展示问题，以及转pdf异常问题总结

解决HTML表格首行单列、后续多列导致Word仅导出一列 PDF转换失败保留合并单元格前言在做 HTML转Word、再转PDF 功能时非常容易遇到一种经典坑- 表格第一行只有 1 个 td 标题行、合并单元格- 后面数据行有 5 列或多列- 结果Word只导出第一列后面列全丢- 转PDF直接报错、导出失败网上大部分方案都是遍历所有行取最大列数给每行补空td。但这会带来一个新问题原本想合并的首行被硬生生补成了多列合并效果没了。这篇文章带你- 保留首行合并单元格效果- 保证所有行结构一致- Word正常导出全部列- PDF完美转换不报错一、问题场景还原你的表格结构大概长这样htmltable!-- 首行1个td想整行合并 --trtd标题/td/tr!-- 数据行5个td --trtd1/tdtd2/tdtd3/tdtd4/tdtd5/td/tr/table出现的问题1. 老代码只取第一行td数量 → tdCount 12. 后面列直接被截断 → Word只显示第一列3. 强行导出后行列数不统一 → PDF工具校验不通过直接抛错二、根本原因- Word对表格结构容错高列少了也能勉强渲染- PDF生成库POI、Aspose、Documents4J等严格校验每行列数必须一致- 首行1列、后续5列 → 结构不合法 → PDF直接失败三、正确解决方案保留首行合并核心思路最重要1. 遍历所有行算出最大列数比如 52. 首行不补td而是给它加上 colspan最大列数3. 其他行列不够就补空td4. 最终所有行实际占列数一致首行依旧是合并单元格结构就变成htmltrtd colspan5标题/td/trtrtd1/tdtd2/tdtd3/tdtd4/tdtd5/td/tr这样- 首行还是合并一格- 逻辑占5列和数据行一致- PDF、Word全部正常四、完整可直接使用代码步骤1遍历所有tr拿到最大列数 tdCountjava// 你的表格tr字符串String tr_group ...;String[] split tr_group.split(/tr);// 最大列数int tdCount 0;for (String tr : split) {int currentCol 0;String[] tds tr.split(/td);for (String td : tds) {if (td.contains(td)) {currentCol;}}// 计算colspan占用的列Pattern p Pattern.compile(colspan\(\\d)\);Matcher m p.matcher(tr);while (m.find()) {int colspan Integer.parseInt(m.group(1));currentCol (colspan - 1);}// 更新最大列if (currentCol tdCount) {tdCount currentCol;}}步骤2循环处理每一行重点首行特殊处理这一段直接贴进你原来的for循环里高亮部分是关键改动javafor (int trIndex 0; trIndex split.length; trIndex) {String tr split[trIndex];String[] tds tr.split(/td);ListTableContent tempList new ArrayList();// // 【计算当前行真实列数】// int currentColCount 0;for (String td : tds) {if (td.contains(td)) {currentColCount;}}Pattern pattern Pattern.compile(colspan\(\\d)\);Matcher matcher pattern.matcher(tr);while (matcher.find()) {int colspan Integer.parseInt(matcher.group(1));currentColCount (colspan - 1);}// // 【核心首行不加空td而是加 colspan】// if (trIndex 0) {// 首行只有1列并且没有colspan → 加上colspan最大列数if (currentColCount 1 !tr.contains(colspan)) {// 替换 td 为 td colspan5tr tr.replaceFirst(td, td colspan\ tdCount \);}} else {// // 非首行列不够 → 补空td// int needAdd tdCount - currentColCount;if (needAdd 0) {StringBuilder sb new StringBuilder(tr);for (int i 0; i needAdd; i) {sb.append(td/td);}tr sb.toString();}}// 重新拆分td必须加tds tr.split(/td);// // 下面是你原来的代码不动// if (trIndex 0) {if (trCount ! 1) {trCount 0;}} else {trCount 0;}// 你的rowspan处理int mergeCount 0;String mergereg rowspan\\\d\;Pattern mergecompile Pattern.compile(mergereg);Matcher mergematcher mergecompile.matcher(tr);while (mergematcher.find()) {String s mergematcher.group();String num s.substring(9, s.lastIndexOf(\));mergeCount Integer.parseInt(num);}// 你原来遍历td、封装TableContent逻辑...}五、为什么这样改PDF就不报错了- 首行 td colspan5 → 实际占5列- 数据行5个td → 也是5列- 所有行逻辑列数完全一致- PDF工具结构校验通过正常渲染并且- 首行依旧是一个合并单元格不会被拆成多格- Word展示正常、样式不变- 转PDF100%不报错六、常见踩坑提醒1. 一定要重新 tds tr.split()不然你补完单元格程序还是用旧数组依旧列不对。2. 不要给首行补空td补了就会变成5格合并效果直接没了。3. colspan 必须等于最大列数少了依旧结构不对PDF还是报错。4. 有 rowspan 也要正常计算不影响这套逻辑。七、最终效果- ✅ Word导出全部列正常显示- ✅ 首行保留合并单元格- ✅ 转PDF不再报错、完美导出- ✅ 兼容绝大多数 HTML转Word工具总结遇到首行1列、后面多列表格导出问题记住一句话首行加colspan其他行补空td保证所有行实际占列一致。这是最稳妥、不破坏样式、同时兼容WordPDF的方案。