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 错误。
