ComfyUI 里怎么用 QR Code Generator 节点生成可识别的二维码？

在 ComfyUI 的可视化工作流中，QR Code Generator 节点承担着将文本或链接转换为矩阵码图像的核心任务。它与传统的 Python 脚本生成方式不同，允许用户在不写代码的情况下，通过拖拽连线完成参数配置，并直接接入后续的图像处理链路。该节点底层通常调用 qrcode 或类似库，但在节点界面上屏蔽了复杂 API，只暴露关键参数。

QR Code Generator 节点的基础参数解析

打开 ComfyUI 并加载 QR Code Generator 节点后，最先接触的是数据输入区。这里的 text 或 data 字段用于填写希望编码的内容，可以是网址、纯文本或 JSON 字符串。需要注意的是，内容越长，二维码版本号越高，矩阵点阵越密，在固定输出尺寸下单个码点会变小，从而影响手机摄像头的识别率。

节点中的 error_correction 参数决定纠错等级，一般提供 L、M、Q、H 四档。L 级约可恢复百分之七的数据，H 级可恢复百分之三十。若在生成后还要叠加艺术背景，必须选 Q 或 H，否则遮挡后无法扫码。version 参数可手动指定，留空则自动按内容长度推算，但自动模式在批量任务中可能导致尺寸跳变，建议固定版本以保证工作流稳定。

另一个容易被忽略的是 box_size 与 border。box_size 控制每个码点的像素边长，border 是安静区宽度，规范至少四模块。若 border 过小，部分扫码 App 会拒绝识别。下面代码展示如何用 Python 等价逻辑理解这些参数，帮助对照节点设置。

import qrcode

# 模拟 QR Code Generator 节点基础参数
qr = qrcode.QRCode(
    version=5,            # 对应节点 version 参数
    error_correction=qrcode.constants.ERROR_CORRECT_H,  # 高纠错
    box_size=10,          # 码点像素大小
    border=4              # 安静区模块数
)
qr.add_data("https://ipipp.com")
qr.make(fit=True)
img = qr.make_image(fill_color="black", back_color="white")
img.save("base_qr.png")

将二维码接入 ComfyUI 图像合成链路

单独生成黑白码往往不能满足设计需求，ComfyUI 的优势在于把 QR Code Generator 节点输出的图像送入 Image Composite 或类似混合节点。此时要注意色彩空间一致性，节点默认输出 RGB 的 PIL 图像，若上游 Load Image 读取的是带透明通道的 PNG，需在合成前用 Remove Alpha 节点处理，否则会出现黑底块。

在实践中，常见做法是先生成 H 级纠错的标准码，再用不透明度百分之四十到六十的风格化图层叠加。这样即使艺术图覆盖了部分码点，剩余数据点仍可被还原。如果直接把二维码作为底层并用高对比笔刷涂改，很容易破坏定位角，导致所有扫码器失效。下方示例展示在节点逻辑之外，如何用代码评估叠加后的可读性。

我们可以用 OpenCV 模拟解码，验证合成图是否合格。这不属于节点必选项，但是排查问题的有效手段。当解码返回 None，说明遮挡过重，需要回退节点调低风格层权重或提高纠错等级。这种闭环检查能显著减少反复手动扫码的时间。

import cv2

# 读取合成后的二维码图，模拟手机解码
image = cv2.imread("composite_qr.png")
detector = cv2.QRCodeDetector()
data, points, _ = detector.detectAndDecode(image)
if not data:
    print("识别失败，需降低遮挡或提高纠错等级")
else:
    print("解码内容:", data)

常见生成故障与节点排错思路

不少用户在 QR Code Generator 节点遇到输出全黑或全白图像，多数源于 fill_color 与 back_color 设置冲突，或上游传入了错误的数据类型。节点期望文本为字符串，若从其他节点拿到了列表或字典且未转字符串，就会编码异常。此时应在前置节点加一个 String Format 或 Python 节点做类型转换。

另一个高频问题是生成的码在电脑上能扫，在老旧安卓机上失败。这通常因为 box_size 太小且手机镜头分辨率低。解决办法是在节点中将输出分辨率放大一倍，或降低 version 自动上限。也可以借助 Save Image 节点导出后，用草料等工具二次校验，再决定是否批量跑图。

最后要注意 ComfyUI 版本差异，部分第三方节点包把 QR Code Generator 拆成了 QR Text 与 QR Render 两个节点，参数名略有变化但原理一致。迁移工作流时应以节点说明中的 error_correction 映射表为准，避免把 H 错配成数字 2 导致异常。掌握上述排错路径，基本可以应对日常二维码生成任务。

ComfyUIQR_Code_Generator二维码生成修改时间：2026-08-16 16:42:30