Laravel生成的80尺寸带Logo二维码模糊问题及修复需求

问题原因 #

直接生成80px小尺寸二维码时，细节密度不足，加上合并Logo时的缩放处理，导致两者都出现模糊。

解决步骤及代码示例 #

1. 生成高分辨率二维码，再按需缩小显示

先生成大尺寸（如400px）的二维码保留足够细节，之后通过前端或后端处理缩小到目标尺寸（80px），避免直接生成小图丢失细节。

修改后的生成代码：

QrCode::format('png')
    ->merge(public_path('img/test.jpg'), 0.2, true) // 调整Logo比例为0.2，避免过大覆盖二维码且模糊
    ->size(400) // 生成400px高分辨率二维码
    ->errorCorrection('H')
    ->backgroundColor(0, 0, 0)
    ->color(231, 195, 111)
    ->generate(public_path('qrcode_large.png'));

前端显示时缩小：

<img src="{{ asset('qrcode_large.png') }}" width="80" height="80" alt="清晰二维码">

2. 优化Logo资源与合并逻辑

• 确保使用高分辨率Logo图片，避免用低像素图片放大；
• 若需要后端处理Logo尺寸，可借助intervention/image扩展先将Logo调整为合适大小再合并：

// 先处理Logo为小尺寸高清图
$logo = \Intervention\Image\Facades\Image::make(public_path('img/test.jpg'))
    ->resize(80, 80, function ($constraint) {
        $constraint->aspectRatio();
        $constraint->upsize(); // 避免放大低分辨率图
    });
$logo->save(public_path('img/logo_small.png'));

// 合并处理后的Logo到高分辨率二维码
QrCode::format('png')
    ->merge(public_path('img/logo_small.png'), 0.2, true)
    ->size(400)
    ->errorCorrection('H')
    ->backgroundColor(0, 0, 0)
    ->color(231, 195, 111)
    ->generate(public_path('qrcode_clear.png'));

参考解决方案翻译 #

1. 优先生成大尺寸二维码（如500px），再通过前端CSS或img标签的width属性缩小到所需尺寸；
2. 使用高分辨率的Logo素材，禁止拉伸低像素图片；
3. 调整merge方法的比例参数，建议设置在0.2-0.3之间，平衡Logo大小与清晰度；
4. 前端显示时避免强制拉伸图片，保持二维码的原始比例。

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