本地与UAT服务器生成带二维码位图文件不一致的原因排查

看起来你遇到了本地生成效果正常，但部署到UAT服务器后图像不符合预期的问题——虽然你觉得代码没问题，但服务器环境和本地的细微差异往往是这类问题的根源。结合你的代码，我整理了几个最可能的原因和对应的解决思路：

1. 字体缺失或拼写错误 #

你的代码里用了new Font("Ariel", 26, FontStyle.Bold, GraphicsUnit.Pixel)，这里有两个潜在问题：

• 首先是拼写错误：正确的字体名应该是Arial，不是Ariel。本地可能因为系统自动纠错或者特殊环境兼容了这个错误，但服务器上没有这个名字的字体，会自动 fallback 到默认字体，直接导致文本样式、位置混乱。
• 其次，就算拼写正确，UAT服务器通常是无桌面环境的服务器系统，默认不会预装Arial这类桌面字体。当指定的字体不存在时，GDI+会用系统内置的替代字体，完全打乱你的布局。

解决方法：

• 修正字体名拼写为"Arial"；
• 要么在UAT服务器上手动安装Arial字体；
• 要么改用服务器肯定存在的系统字体，比如"Segoe UI"、"Microsoft Sans Serif"；
• 更稳妥的方式是把字体文件嵌入到你的应用程序中，通过PrivateFontCollection加载。

2. 二维码的JPEG格式压缩问题 #

你生成二维码时把图像转成了JPEG格式（qrCodeImage.ToByteArray(ImageFormat.Jpeg)），JPEG是有损压缩格式，对二维码这种高对比度的黑白图像来说，容易出现边缘模糊、色块失真的情况。本地可能因为环境差异压缩效果不明显，但服务器上的GDI+处理逻辑可能导致失真更严重。

解决方法：
把二维码的输出格式改成PNG（无损压缩），修改生成二维码的代码：

return qrCodeImage.ToByteArray(ImageFormat.Png);

3. GDI+渲染参数差异 #

本地和服务器的GDI+默认渲染设置可能不同，比如文本抗锯齿、图像平滑度等，这会导致生成的图像在细节上有差异。

解决方法：
在绘制图像前，手动设置统一的渲染参数，确保跨环境一致：

using (var graphics = Graphics.FromImage(emptyImage))
{
    // 添加这些渲染设置
    graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
    graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality;
    graphics.PixelOffsetMode = System.Drawing.Drawing2D.PixelOffsetMode.HighQuality;
    
    // 后续的绘制代码...
}

4. 文件写入权限不足 #

UAT服务器上的目标路径filePath可能没有给应用程序池的运行身份分配足够的读写权限，导致图像文件保存不完整或者损坏。

解决方法：

• 检查服务器上filePath对应的文件夹权限，确保应用程序池的身份（比如IIS AppPool\YourAppPoolName）有读写权限；
• 可以临时把文件保存到服务器的临时目录（比如Path.GetTempPath()）测试，排除权限问题。

5. QRCode库版本不一致 #

本地和UAT服务器上使用的QRCode生成库版本可能不同，不同版本的库在生成二维码的细节、图像输出上可能有差异，甚至存在服务器环境的兼容性问题。

解决方法：

• 确认服务器上的NuGet包版本和本地完全一致；
• 如果使用的是第三方库，查看其文档有没有服务器环境下的特殊配置要求。

修正后的完整代码示例 #

结合上面的优化点，这里是调整后的代码：

var qrCode = GenerateQrCode(url);
using (Image emptyImage = new Bitmap(500, 600))
{
    using (var graphics = Graphics.FromImage(emptyImage))
    {
        // 统一渲染参数
        graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
        graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality;
        graphics.PixelOffsetMode = System.Drawing.Drawing2D.PixelOffsetMode.HighQuality;
        
        // 修正字体名并使用系统可靠字体
        var font = new Font("Arial", 26, FontStyle.Bold, GraphicsUnit.Pixel);
        graphics.Clear(Color.White);
        graphics.DrawString(QrPortal.BLL.Resources.lmame.ToUpper(), font, Brushes.Black, 75, 15);
        
        using (var qrImage = Image.FromStream(new MemoryStream(qrCode)))
        {
            graphics.DrawImage(qrImage, 50, 70);
        }
        
        graphics.DrawString(QrPortal.BLL.Resources.scanme, font, Brushes.Black, 180, 500);
    }
    emptyImage.Save(filePath, System.Drawing.Imaging.ImageFormat.Png);
}

private static Byte[] GenerateQrCode(string url)
{
    QRCodeGenerator qrGenerator = new QRCodeGenerator();
    QRCodeData qrCodeData = qrGenerator.CreateQrCode(url, QRCodeGenerator.ECCLevel.H);
    QRCode qrCode = new QRCode(qrCodeData);
    var qrCodeImage = qrCode.GetGraphic(9);
    // 使用PNG格式避免压缩失真
    return qrCodeImage.ToByteArray(ImageFormat.Png);
}

内容的提问来源于stack exchange，提问作者Frederik De Clercq