添加宽高样式后iTextSharp生成PDF中图片不显示问题求助

我之前在做类似的HTML转PDF功能时，也踩过iTextSharp 5.5.x处理图片inline样式的坑，咱们来一步步解决这个问题：

问题根源 #

iTextSharp 5.5.10对HTML里图片的style属性中width/height的解析支持非常有限，尤其是inline写的尺寸样式，它无法正确识别这些参数，导致图片渲染失败甚至直接不显示。

解决方案 #

方案1：改用HTML原生的width/height属性（最简单直接） #

iTextSharp对图片的原生width和height属性支持很稳定，我们可以把CKEditor生成的带style尺寸的图片标签，替换成原生属性的形式。比如：

• 原标签：<img style="width:200px;height:150px;" src="your-image-path" />
• 替换后：<img width="200" height="150" src="your-image-path" />

你可以在获取到htmlText后，用正则快速替换：

// 正则匹配并替换style中的width/height为原生属性
htmlText = Regex.Replace(htmlText, 
    @"<img(.*?)style=""(.*?)width:\s*(\d+)px;\s*(.*?)height:\s*(\d+)px;\s*(.*?)""(.*?)>", 
    match => $"<img{match.Groups[1]}width=\"{match.Groups[3]}\" height=\"{match.Groups[5]}\" style=\"{match.Groups[2]}{match.Groups[4]}{match.Groups[6]}\"{match.Groups[7]}>", 
    RegexOptions.IgnoreCase | RegexOptions.Singleline);

这个正则会保留style里的其他属性，只把width/height提取出来转为原生属性。

方案2：切换到XMLWorker处理（更适合复杂CSS场景） #

你当前用的应该是旧的HTMLWorker，它在iTextSharp 5.5.x版本已经被标记为过时，推荐使用XMLWorker，它对CSS的支持更完善，能正确解析inline style中的尺寸：

string htmlText = "你的CKEditor生成的HTML内容";
using (StringReader sr = new StringReader(htmlText))
{
    Document pdfDoc = new Document(PageSize.A4, 0, 0, 0, 18f);
    PdfWriter writer = PdfWriter.GetInstance(pdfDoc, Response.OutputStream);
    
    // 初始化PDF文档
    pdfDoc.Open();
    
    // 配置XMLWorker的CSS解析器
    StyleAttrCSSResolver cssResolver = new StyleAttrCSSResolver();
    // 可以添加全局CSS（比如限制图片最大宽度避免超出页面）
    ICSSFile cssFile = XMLWorkerHelper.GetCSS(new StringReader("img { max-width: 100%; height: auto; }"));
    cssResolver.AddCss(cssFile);
    
    // 设置HTML上下文
    HtmlPipelineContext htmlContext = new HtmlPipelineContext(new CssAppliersImpl(new XMLWorkerFontProvider()));
    htmlContext.SetTagFactory(Tags.GetHtmlTagProcessorFactory());
    
    // 构建处理管道
    IPipeline pipeline = new CssResolverPipeline(cssResolver, 
        new HtmlPipeline(htmlContext, new PdfWriterPipeline(pdfDoc, writer)));
    
    // 创建XMLWorker并解析HTML
    XMLWorker xmlWorker = new XMLWorker(pipeline, true);
    XMLParser xmlParser = XMLWorkerHelper.CreateParser(Encoding.UTF8, xmlWorker);
    xmlParser.Parse(sr);
    
    pdfDoc.Close();
}

额外注意点 #

• 确保图片的路径是iTextSharp能访问到的：如果是本地文件路径，要保证应用程序有读取权限；如果是base64编码的图片，要确保格式正确（比如data:image/png;base64,...）。
• 如果用CKEditor，也可以在编辑器设置里，让它插入图片时直接生成原生width/height属性，而不是style样式，从源头避免问题。

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