若ThinkPHP中二维码无法输出或样式失效，需依次执行：一、Composer安装endroid/qrcode；二、控制器中引用命名空间、设内容与参数、设PNG响应头并输出；三、用writeFile保存至服务器；四、用setLogoPath嵌入PNG Logo；五、封装为QrCodeService服务类复用。
如果您在ThinkPHP项目中需要动态生成二维码，但发现无法正确输出图像或样式配置失效，则可能是由于库未正确安装、命名空间引用错误或响应头设置不当所致。以下是解决此问题的步骤：
一、通过Composer安装Endroid/QrCode库
该步骤确保项目具备二维码生成所需的核心类与依赖组件，且兼容ThinkPHP的自动加载机制。
1、在ThinkPHP项目根目录下打开终端或命令行工具。
2、执行安装命令：composer require endroid/qrcode。
立即学习“PHP免费学习笔记（深入）”；
3、确认vendor/endroid/qrcode目录已成功创建，并检查composer.json中是否新增对应依赖项。
二、在控制器中实例化并输出二维码
此方法适用于需即时返回PNG图像供前端标签直接调用的场景，要求正确设置HTTP响应头以避免乱码或下载行为。
1、在控制器顶部添加命名空间引用：use Endroid\QrCode\QrCode;。
2、定义操作方法，例如public function generateQr() { }。
3、创建QrCode实例并设置内容：$qrCode = new QrCode('https://example.com');。
4、配置基础参数：尺寸、边距、容错等级及前景/背景色，如$qrCode->setSize(200)->setMargin(5)->setErrorCorrectionLevel('high');。
5、设置响应头为PNG类型：header('Content-Type: image/png');。
6、调用writeString()方法输出图像流：echo $qrCode->writeString();。
7、立即终止脚本执行：exit;。
三、将二维码保存至服务器指定路径
该方式适用于需长期复用、批量生成或配合CDN分发的业务场景，避免重复渲染开销。
1、在控制器中构造唯一文件路径，例如：$filePath = './public/qrcode/' . md5($content) . '.png';。
2、确保目标目录存在，若不存在则递归创建：if (!is_dir(dirname($filePath))) mkdir(dirname($filePath), 0755, true);。
3、调用writeFile()方法保存图像：$qrCode->writeFile($filePath);。
4、返回相对URL供前端访问，如return '/qrcode/' . md5($content) . '.png';。
四、在二维码中心嵌入自定义Logo
嵌入透明背景PNG格式Logo可增强品牌识别度，同时保持扫码可靠性，需注意尺寸比例与位置控制。
1、准备尺寸适配的Logo图片，推荐宽度不超过二维码总宽的20%，格式为PNG且含Alpha通道。
2、使用setLogoPath()指定Logo路径：$qrCode->setLogoPath('./public/static/logo.png');。
3、限制Logo最大宽度以防止覆盖关键模块：$qrCode->setLogoWidth(40);。
4、启用居中嵌入逻辑（默认生效），无需额外调用居中方法。
五、封装为可复用的服务类
将二维码生成逻辑抽象为独立服务，提升代码可维护性与跨控制器复用能力，符合ThinkPHP分层设计规范。
1、在application/common/service/目录下新建QrCodeService.php文件。
2、定义类并注入配置参数，如size、margin、logo_path、error_correction_level等。
3、在构造函数中初始化QrCode实例，并预设通用样式参数。
4、提供generate()方法接收内容字符串，返回图像数据或文件路径。
5、在控制器中通过Loader::import()或容器绑定方式调用该服务：$qrService = new QrCodeService(['size' => 250, 'logo_path' => './logo.png']);。
