使用wkhtmltopdf转PDF时，如何避免表格td内容过长丢失边框？

针对td内容过长导致PDF分页后表格上下边框消失的问题，给你几个实测有效的解决思路：

1. 调整表格边框渲染模式 #

放弃border-collapse: collapse，改用分离式边框并清除间距，确保每个单元格的边框独立渲染，不会因为分页合并丢失：

table {
    border-collapse: separate;
    border-spacing: 0;
    width: 100%;
}
table th, table td {
    border: 1px solid #000;
    padding: 0.5rem;
    /* 强制内容换行，避免单元格异常拉伸 */
    word-wrap: break-word;
    white-space: normal;
}

2. 优化分页时的元素渲染 #

给表格行或tbody添加打印专用样式，避免分页切割导致边框丢失：

@media print {
    tbody {
        display: table-row-group;
    }
    tr {
        page-break-inside: avoid;
        /* 若必须分页，强制保留行边框 */
        position: relative;
    }
    /* 给跨页的行底部补边框 */
    tr.page-break:after {
        content: "";
        position: absolute;
        bottom: -1px;
        left: 0;
        width: 100%;
        border-bottom: 1px solid #000;
    }
}

如果需要手动标记分页行，可以在后端生成HTML时给需要分页的tr加上page-break类。

3. 调整wkhtmltopdf命令参数 #

添加以下参数修正渲染异常：

• --disable-smart-shrinking：禁用智能缩放，避免边框被压缩消失
• --margin-top 10mm --margin-bottom 10mm：设置上下边距，防止内容靠近页边导致边框被裁剪
• --dpi 300：提高渲染分辨率，解决低dpi下边框显示不全的问题

示例.Net Core中调用的参数配置：

var processStartInfo = new ProcessStartInfo
{
    FileName = "wkhtmltopdf",
    Arguments = "--disable-smart-shrinking --margin-top 10mm --margin-bottom 10mm --dpi 300 \"input.html\" \"output.pdf\"",
    UseShellExecute = false,
    RedirectStandardOutput = true,
    RedirectStandardError = true
};

4. 检查HTML结构问题 #

确保td内的嵌套元素（如div、p）没有设置overflow: hidden或position: absolute，这类样式会干扰wkhtmltopdf对单元格边框的计算；同时避免表格嵌套过深，尽量保持表格结构扁平化。

内容的提问来源于stack exchange，提问作者小董520