iText7 HTML转PDF：英文长词与长数字无法换行问题求助

我之前也踩过iText7处理英文长单词和连续数字自动换行的坑，结合你的代码、HTML和CSS配置，给你几个亲测有效的解决方案：

一、先调整CSS样式（最直接的修复） #

你已经在单个<p>标签里加了换行规则，但全局的td样式没有配置，iText7对CSS的解析需要明确作用到目标元素上。修改你的CSS文件，给所有table单元格加上强制换行规则：

table td {
    border: 1px solid #000;
    border-left: none;
    height: 40px;
    text-align: center;
    font-size: 14px;
    /* 新增以下两行，强制英文/数字换行 */
    overflow-wrap: break-word;
    word-break: break-all;
}

另外，你的table已经设置了table-layout:fixed，可以给每个td分配固定宽度（因为有9列），确保布局稳定：

table td {
    /* 保留原有样式 */
    width: calc(100% / 9);
}

二、开启iText7的英文断字功能（处理长单词更优雅） #

如果是很长的英文单词，单纯用CSS强制截断会显得生硬，iText7支持自动断字（Hyphenation），能让单词按音节拆分换行：

1. 添加依赖（Maven为例） #

先引入iText7的断字模块，版本和你用的iText7核心包保持一致：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>hyphenation</artifactId>
    <version>7.2.5</version>
</dependency>

2. 修改Java代码配置断字规则 #

在初始化PdfDocument后，添加断字配置：

PdfDocument pdf = new PdfDocument(writer);
pdf.setTagged();
PageSize pageSize = new PageSize(575, 1500);
pdf.setDefaultPageSize(pageSize);

// 新增：配置英文断字，参数为语言、国家、最小前缀长度、最小后缀长度
HyphenationConfig hyphenationConfig = new HyphenationConfig("en", "US", 2, 2);
pdf.getDocumentRenderer().setHyphenationConfig(hyphenationConfig);

三、调整iText7的媒体类型配置 #

你当前设置的是MediaType.SCREEN，iText7对屏幕媒体的CSS解析逻辑和打印媒体有差异，改成MediaType.PRINT可能会解决部分样式兼容问题：

MediaDeviceDescription mediaDeviceDescription = new MediaDeviceDescription(MediaType.PRINT);
converterProperties.setMediaDeviceDescription(mediaDeviceDescription);

为什么原来的配置不生效？ #

1. 换行规则只作用于单个<p>标签，没有全局覆盖所有td，导致其他长内容单元格没触发换行；
2. iText7默认未开启英文断字，长单词无法自动拆分；
3. 屏幕媒体的CSS解析规则可能忽略了部分换行相关属性。

按照上面的步骤修改后，你的长英文（比如www.ctbri.commmmmmmmmmmmmm）和长数字都会自动换行或优雅断字了。

内容的提问来源于stack exchange，提问作者Geologisted