iText 7 HtmlConverter无法折行无空格长串问题求助

阿华AIGC实验室

2026-5-15

解决iText 7 html2PDF 2.0.0中表格内无空格长文本折行问题

我来帮你搞定这个问题——之前在iText 5里好用的长文本折行设置，到iText 7的html2PDF确实需要调整几个关键细节，试试下面的方案：

1. 修正CSS样式的应用方式

你之前尝试的table-layout: fixed;和word-break: break-all;方向是对的，但可能没把样式传递到表格内部的元素上。要确保表格、单元格（td）、内部的p标签都配置了对应的折行规则，避免样式被层级覆盖：

修改后的HTML片段示例：

<table width="70%" style="table-layout: fixed;"> 
  <tbody> 
    <tr> 
      <td width="50%" style="word-break: break-all;">
        <p style="width: 80%; background-color: fuchsia; word-break: break-all;">3aaaa22aaaaaaaaaaaaaaaabbbbbbbbbbbbbbbbbbbbbbbaaaaaaaaaaaaaaaaaaaaaa1</p>
      </td> 
      <td width="50%" style="word-break: break-all;">
        <p style="width: 80%; background-color: cyan; word-break: break-all;">4aaaaaa33aaaaaaaaaaaaaaaaaaaaaaaaaaabbbbbbbbaaaaaaaaaaaaaaaaa2</p>
      </td> 
    </tr>
    <!-- 其他空行保持不变 -->
  </tbody> 
</table>

2. 配置ConverterProperties加载合适字体

iText 7的html2PDF对字体的依赖比iText 5更强，如果默认字体不支持无空格文本的断字规则，即使CSS写对了也没用。你需要在Java代码中添加字体提供者，确保加载支持断字的字体：

修改后的createPdf方法：

public void createPdf(String src, String dest, String resources) throws IOException {
    try {
        FileOutputStream outputStream = new FileOutputStream(dest);
        WriterProperties writerProperties = new WriterProperties();
        writerProperties.addXmpMetadata();
        PdfWriter pdfWriter = new PdfWriter(outputStream, writerProperties);
        PdfDocument pdfDoc = new PdfDocument(pdfWriter);
        ConverterProperties props = new ConverterProperties();

        // 加载系统字体+标准字体，确保有支持断字的字体可用
        FontProvider fontProvider = new DefaultFontProvider(true, true, true);
        // 如果有自定义字体，也可以添加进来：
        // fontProvider.addFont(resources + "your-custom-font.ttf");
        props.setFontProvider(fontProvider);

        HtmlConverter.convertToPdf(new FileInputStream(src), pdfDoc, props);
        pdfDoc.close();
    } catch (Exception e) {
        e.printStackTrace();
    }
}