使用iTextSharp将HTML字符串转PDF时样式不生效问题排查

首先看你遇到的问题：用StringBuilder拼接HTML后转PDF样式不生效，主要有几个核心问题导致，咱们一步步拆解：

1. HTML语法存在明显错误 #

你的拼接HTML里有不少语法问题，这会直接让解析器无法正确识别样式：

• 无效属性写法：<p><style="width:205px; height:35px;"></p> 这里的style属性格式完全错误，应该改成<p style="width:205px; height:35px;"></p>（如果是给段落加样式），或者你可能想写<img>标签？
• 标签格式不规范：多处出现<strong >、</ strong >（标签和闭合符之间有空格），这种写法不符合HTML规范，解析器大概率识别不了加粗样式；还有一些标签闭合带多余空格，比如</ td >。

2. 使用了过时的HTMLWorker组件 #

你代码里用的HTMLWorker是iTextSharp旧版本的HTML解析器，它对CSS样式的支持非常有限，很多常用的CSS属性都不兼容，这才是样式失效的主要原因。

修复方案 #

步骤1：先修正HTML语法错误 #

把拼接的HTML里的语法问题全部改掉，示例片段如下：

sb.Append("<header class='clearfix'>");
sb.Append("<table border=\"1\" cellpadding=\"0\" cellspacing=\"0\">");
sb.Append("<tbody>");
sb.Append("<tr>");
sb.Append("<td style=\"height:47px; width:175px;\">");
sb.Append("<p style=\"width:205px; height:35px;\"></p>"); // 修正style属性写法
sb.Append("</td>");
sb.Append("<td colspan=\"4\" style=\"height:47px; width:553px; background-color:#0d4580; color:aliceblue;\">");
sb.Append("<p style='margin-left:76.45pt'><strong>JOB DESCRIPTION</strong></p>"); // 修正strong标签格式
sb.Append("</td>");
// 其他行同理修正标签格式和语法问题

步骤2：替换为更靠谱的解析组件 #

如果你用的是iTextSharp 5.x，推荐用XmlWorker替代过时的HTMLWorker，它对CSS的支持提升很多。修改后的转PDF代码示例：

protected void Demo()
{
    StringBuilder sb = new StringBuilder();
    // 这里拼接修正后的HTML内容...

    string htmlContent = sb.ToString();
    Document pdfDoc = new Document(PageSize.A4, 10f, 10f, 10f, 0f);

    using (MemoryStream memoryStream = new MemoryStream())
    {
        PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
        pdfDoc.Open();

        // 使用XmlWorker解析HTML和CSS
        using (StringReader sr = new StringReader(htmlContent))
        {
            XmlWorkerHelper.GetInstance().ParseXHtml(writer, pdfDoc, sr);
        }

        pdfDoc.Close();
        byte[] bytes = memoryStream.ToArray();

        // 输出PDF到Response
        Response.Clear();
        Response.ContentType = "application/pdf";
        Response.AddHeader("Content-Disposition", "attachment; filename=JobDescription.pdf");
        Response.Buffer = true;
        Response.Cache.SetCacheability(HttpCacheability.NoCache);
        Response.BinaryWrite(bytes);
        Response.End();
    }
}

如果已经升级到iText 7（推荐，因为iTextSharp已经停止维护），可以直接用HtmlConverter，它对CSS的支持更完善：

protected void Demo()
{
    StringBuilder sb = new StringBuilder();
    // 拼接修正后的HTML内容...

    string htmlContent = sb.ToString();
    using (MemoryStream memoryStream = new MemoryStream())
    {
        // 使用iText 7的HtmlConverter直接转换
        HtmlConverter.ConvertToPdf(htmlContent, memoryStream);
        byte[] bytes = memoryStream.ToArray();

        // 输出PDF
        Response.Clear();
        Response.ContentType = "application/pdf";
        Response.AddHeader("Content-Disposition", "attachment; filename=JobDescription.pdf");
        Response.Buffer = true;
        Response.Cache.SetCacheability(HttpCacheability.NoCache);
        Response.BinaryWrite(bytes);
        Response.End();
    }
}

步骤3：优化CSS属性写法 #

为了确保样式被正确解析，建议：

• 使用完整的CSS属性名，比如background-color而不是简写的background（兼容性更好）
• 单位优先用px或pt，避免解析器不识别的单位
• 内联样式尽量简洁明确，复杂样式可以抽离到HTML的<style>标签中（XmlWorker和HtmlConverter都支持解析内部样式表）

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