simplesoftwareio/simple-qrcode 在 Laravel 10+ 中默认失效，因其依赖已废弃的 illuminate/support v8–v9 辅助函数且未适配新响应机制；推荐改用 chillerlan/php-qrcode 并手动处理响应、缓存与 UTF-8 中文编码。

Simple-QrCode 在 Laravel 10+ 中已不兼容，别再硬装

直接说结论：simplesoftwareio/simple-qrcode 包在 Laravel 10 及以上版本中默认失效，核心原因是它依赖已废弃的 illuminate/support v8–v9 的辅助函数（如 str_random()），且未适配 Laravel 的新响应机制（BinaryFileResponse 替代 Response::make()）。强行 composer require 后调用 QrCode::generate() 会报 Class 'Str' not found 或 Call to undefined method Illuminate\Http\Response::make()。

推荐替代方案：使用 chillerlan/php-qrcode + 自定义响应

这是目前最轻量、无 Laravel 绑定、 actively maintained 的 QR 生成库。它不封装 HTTP 响应，正好规避了扩展包与框架版本耦合的问题，你只需控制输出即可。

• 安装：composer require chillerlan/php-qrcode
• 基础用法（返回 PNG 二进制流）：

use chillerlan\QRCode\QRCode;
use chillerlan\QRCode\QROptions;

$options = new QROptions([
    'outputType' => QRCode::OUTPUT_IMAGE_PNG,
    'scale'      => 4,
    'margin'     => 2,
]);

$qrcode = new QRCode($options);
$pngData = $qrcode->render('https://example.com');

return response($pngData)
    ->header('Content-Type', 'image/png')
    ->header('Content-Disposition', 'inline; filename="qrcode.png"');

注意：render() 返回的是原始 PNG 二进制字符串，不是文件路径，不能直接丢给 asset()；必须走 response() 输出。

需要缓存二维码图片？别存 PNG，改用 Base64 或临时文件

Laravel 的 Storage 不适合直接存 PNG 二进制流（易损坏、读取需额外解码），更稳妥的方式是：

• 前端需要内联显示时：用 data:image/png;base64,' . base64_encode($pngData) 直接嵌入
• 需长期访问 URL 时：写入 storage/app/qrcodes/ 并用 Storage::url() 生成可访问链接（确保已配置 APP_URL 和 public 链接）
• 避免并发写冲突：对同一内容做 MD5 哈希命名，例如 storage_path('app/qrcodes/' . md5($content) . '.png')

中文内容生成乱码？必须显式设置 UTF-8 编码

chillerlan/php-qrcode 默认不处理中文字符编码，若传入未编码的中文字符串（如 '你好'），会生成空白或异常图案。正确做法是：

• 确保输入是 UTF-8 字符串（Laravel 默认满足）
• 但必须启用 eccLevel 和 version 显式支持中文容量，例如：

$options = new QROptions([
    'outputType' => QRCode::OUTPUT_IMAGE_PNG,
    'eccLevel'   => QRCode::ECC_H, // 高容错，保障中文不被截断
    'version'    => 10,            // 版本越高，容纳汉字越多（UTF-8 下每个汉字占 3 字节）
    'scale'      => 3,
]);

$qrcode = new QRCode($options);
$pngData = $qrcode->render('二维码内容：测试中文'); // ✅ 正确

如果仍乱码，检查是否误用了 urlencode() —— 这会导致 URL 编码后长度暴增，超出 QR 容量，直接传原始 UTF-8 字符串即可。

真正麻烦的从来不是“怎么画个方块”，而是字符编码、响应类型、缓存策略这三处细节。漏掉任意一个，页面就只显示一个破损图标或 500 错误。