java制作二维码

本页面系统梳理了java制作二维码的完整技术路径,从基础原理到企业级实践,覆盖ZXing、QRGen、OnBarcode、BoofCV等主流库的深度对比与实战示例,延伸至二维码生成中的安全风险、合规边界、性能调优及Web集成方案,为开发者提供可落地、可扩展的二维码解决方案。

⚡

主流库选型

对比ZXing、QRGen、OnBarcode、BoofCV等java制作二维码库的API复杂度、依赖体积、功能完整性与社区支持度,助您快速锁定适配项目规模与技术栈的最优解。

⚙️

深度定制

支持二维码尺寸、纠错等级、颜色、Logo嵌入、圆角/阴影、动态渐变等多维样式定制,满足品牌化、场景化视觉需求。

〔

企业集成

详解Spring Boot、Jakarta EE、微服务架构下二维码服务的模块化封装、异步生成、缓存策略与高并发优化路径。

一、二维码原理与Java实现基础

二维码(QR Code)是一种矩阵式二维条码,由日本Denso Wave公司于1994年发明,具备高容错、高容量、快速解码等特性。其核心结构包含定位图案、格式信息、版本信息、数据与纠错码字等模块。容错等级分为L(7%)、M(15%)、Q(25%)、H(30%),不同等级对应不同冗余强度,直接影响编码效率与容灾能力。

在java制作二维码时,需明确三个核心环节:数据编码(将原始文本转换为字节序列)、矩阵生成(映射为0/1矩阵)、图像渲染(绘制为PNG/JPEG等格式)。ZXing作为Google开源的二维码处理库,提供完整的编码器与解码器模块,是java制作二维码最广泛采用的底层依赖。

ZXing核心类:
• QRCodeWriter:执行编码与矩阵生成
• BitMatrix:二维布尔矩阵,表示二维码像素布局
• MatrixToImageWriter:将BitMatrix渲染为BufferedImage

依赖引入(Maven):

<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>core</artifactId>
    <version>3.5.3</version>
</dependency>
<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>javase</artifactId>
    <version>3.5.3</version>
</dependency>

二、主流二维码生成库深度对比

ZXing:工业级标准库

ZXing(Zebra Crossing)是目前java制作二维码 • 支持QR Code、Data Matrix、PDF417等20+条码格式
• 提供命令行、Android、Java SE三套适配模块
• 源码结构清晰,易于二次开发
• 社区活跃,文档丰富,Bug修复及时

典型用法:

import com.google.zxing.*;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import java.nio.file.FileSystems;
import java.nio.file.Path;
public class QrGenZXing {
    public static void main(String[] args) throws Exception {
        String content = "https://www.xservx.com";
        int width = 300, height = 300;
        QRCodeWriter writer = new QRCodeWriter();
        BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height);
        Path path = FileSystems.getDefault().getPath("qrcode.png");
        MatrixToImageWriter.writeToPath(matrix, "PNG", path);
    }
}

ZXing编码流程中,java制作二维码的关键参数配置如下:

参数类型说明推荐值
ERROR_CORRECTIONHintType.ERROR_CORRECTION纠错等级ErrorCorrectionLevel.M
CHARACTER_SETString编码字符集"UTF-8"
MARGINInteger白边边距(模块数)4
WIDTH / HEIGHTInteger图像尺寸(像素)300x300

QRGen:ZXing的轻量封装

QRGen是对ZXing的友好封装,通过Fluent API大幅简化API调用,适合快速开发。其核心类为QRCode类,支持链式调用生成二维码图像。

依赖(Maven):

<dependency>
    <groupId>"net.glxn.qrgen</groupId>
    <artifactId>qrgen</artifactId>
    <version>2.0</version>
</dependency>

示例代码:

import net.glxn.qrgen.QRCode;
import net.glxn.qrgen.image.ImageType;
import java.io.FileOutputStream;
public class QrGenSimple {
    public static void main(String[] args) throws Exception {
        QRCode.from("https://www.xservx.com")
              .to(ImageType.PNG)
              .withSize(300, 300)
              .withErrorCorrection(ErrorCorrectionLevel.M)
              .writeTo(new FileOutputStream("qrcode.png"));
    }
}

QRGen优势在于:
• 无需手动处理BitMatrix
• 内置异常处理与资源释放
• 支持SVG、JPEG、GIF等多格式输出
但其对ZXing内部机制封装较深,高级定制能力受限。

OnBarcode:商业级稳定方案

OnBarcode提供企业级java制作二维码服务,支持JSP/Servlet、Java SE、Android等全平台,具备以下特点:
• 零依赖,纯Java实现
• 支持自定义二维码Logo、颜色、旋转角度
• 提供在线演示与技术文档
• 商业授权模式(免费版有水印)

核心类:QRCode(com.onbarcode.barcode.java.QRCode)

示例:

import com.onbarcode.barcode.java.QRCode;
public class QrOnBarcode {
    public static void main(String[] args) {
        QRCode qr = new QRCode();
        qr.setData("https://www.xservx.com");
        qr.setDataMode(QRCode.DATA_MODE_8BIT);
        qr.setQuietZone(4);
        qr.setUnitSize(3);
        qr.setSize(300);
        qr.drawImage("qrcode.png");
    }
}

适合对稳定性要求高、需商业支持的中大型项目。

BoofCV:计算机视觉集成方案

BoofCV是面向计算机视觉的Java库,其二维码模块支持生成与解码一体化,适合需要同时处理图像采集、识别、生成的场景(如AR应用)。支持QR Code、Data Matrix、Aztec等格式。

优势:
• 高精度解码器(支持模糊/畸变图像)
• 内置图像预处理与后处理模块
• 支持GPU加速(通过JOCL)
• 开源协议宽松(Apache 2.0)

依赖:

<dependency>
    <groupId>org.boofcv</groupId>
    <artifactId>boofcv-core</artifactId>
    <version>0.43</version>
</dependency>

生成二维码:

import boofcv.alg.fiducial.qrcode.QrCode;
import boofcv.alg.fiducial.qrcode.QrEncoder;
import boofcv.struct.image.GrayU8;
import boofcv.io.image.ConvertBufferedImage;
import java.awt.image.BufferedImage;
public class QrBoofCV {
    public static void main(String[] args) {
        QrEncoder encoder = new QrEncoder(QrCode.ErrorCorrectionLevel.M);
        QrCode qr = encoder.encode("https://www.xservx.com".getBytes());
        GrayU8 image = qr.generateImage(3, 300, 300);
        BufferedImage buf = ConvertBufferedImage.convertTo(image, null);
        // 保存为PNG...
    }
}

三、java制作二维码核心代码实战

3.1 基础生成(ZXing)

以下代码实现带自定义白边、纠错等级为H的二维码生成:

import com.google.zxing.*;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
import java.nio.file.FileSystems;
import java.nio.file.Path;
public class QrAdvanced {
    public static void main(String[] args) throws Exception {
        String content = "https://www.xservx.com";
        int width = 400, height = 400;
        QRCodeWriter writer = new QRCodeWriter();
        // 配置编码参数
        java.util.Map hints = new java.util.HashMap<>();
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H);
        hints.put(EncodeHintType.MARGIN, 2);
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
        Path path = FileSystems.getDefault().getPath("qrcode_h.png");
        MatrixToImageWriter.writeToPath(matrix, "PNG", path);
    }
}

3.2 带Logo嵌入

嵌入品牌Logo可提升识别率与品牌曝光,但需注意:
• Logo尺寸建议≤二维码中心区域(20%面积)
• Logo应为纯色或高对比度图案
• 需保证Logo区域二维码模块未被完全遮挡

import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
public class QrWithLogo {
    public static void main(String[] args) throws Exception {
        // 生成基础二维码
        String content = "https://www.xservx.com";
        int width = 400, height = 400;
        QRCodeWriter writer = new QRCodeWriter();
        java.util.Map hints = new java.util.HashMap<>();
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H);
        BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
        // 转换为BufferedImage
        BufferedImage qrImage = MatrixToImageWriter.toBufferedImage(matrix);
        // 加载Logo
        BufferedImage logo = ImageIO.read(new File("logo.png"));
        int logoWidth = qrImage.getWidth() / 5;
        int logoHeight = logoWidth;
        logo = logo.getScaledInstance(logoWidth, logoHeight, Image.SCALE_SMOOTH);
        // 绘制Logo
        Graphics2D g = qrImage.createGraphics();
        int x = (qrImage.getWidth() - logoWidth) / 2;
        int y = (qrImage.getHeight() - logoHeight) / 2;
        g.drawImage(logo, x, y, null);
        g.dispose();
        // 保存
        ImageIO.write(qrImage, "PNG", new File("qrcode_logo.png"));
    }
}

3.3 动态生成(Spring Boot)

在Web应用中,动态生成二维码需考虑:
• 使用流式输出避免内存溢出
• 设置缓存策略(Cache-Control)
• 实现HTTP 304 Not Modified支持

@RestController
@RequestMapping("/api/qrcode")
public class QrController {
    @GetMapping("/generate")
    public void generateQrCode(@RequestParam String text,
                               @RequestParam(defaultValue = "300") int size,
                               HttpServletResponse response) throws Exception {
        response.setContentType("image/png");
        response.setHeader("Cache-Control", "public, max-age=86400");
        QRCodeWriter writer = new QRCodeWriter();
        java.util.Map hints = new java.util.HashMap<>();
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.M);
        hints.put(EncodeHintType.MARGIN, 1);
        BitMatrix matrix = writer.encode(text, BarcodeFormat.QR_CODE, size, size, hints);
        MatrixToImageWriter.writeToStream(matrix, "PNG", response.getOutputStream());
    }
}

四、二维码样式定制与品牌化

纯黑白二维码在UI中易显单调,现代应用常需定制:
• 颜色:前景色(二维码模块)、背景色
• 形状:圆角、圆形、渐变填充
• 嵌入:Logo、装饰元素、品牌色块

颜色定制:前景/背景色控制

ZXing默认生成黑白二维码,可通过MatrixToImageConfig自定义颜色:

import com.google.zxing.client.j2se.MatrixToImageConfig;
import com.google.zxing.client.j2se.MatrixToImageWriter;
// 定义颜色:前景色#037ef3,背景色#ffffff
MatrixToImageConfig config = new MatrixToImageConfig(0x037ef3, 0xffffff);
MatrixToImageWriter.writeToPath(matrix, "PNG", path, config);

支持ARGB颜色值(0xAARRGGBB),可实现透明背景(alpha通道=0x00)。

形状定制:圆角与圆形模块

ZXing原生不支持圆角,但可通过后处理实现:

  1. 生成基础二维码BitMatrix
  2. 遍历非白边区域,将矩形模块替换为圆形路径
  3. 使用Graphics2D绘制圆形模块

示例伪代码:

BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);
Graphics2D g = image.createGraphics();
g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
g.setColor(new Color(0x037ef3));
for (int x = 0; x < width; x++) {
    for (int y = 0; y < height; y++) {
        if (matrix.get(x, y)) {
            int radius = (int)(moduleSize * 0.8);
            g.fillOval(x * moduleSize + (moduleSize - radius)/2,
                       y * moduleSize + (moduleSize - radius)/2,
                       radius, radius);
        }
    }
}

五、动态二维码与Web集成

5.1 URL重定向型动态二维码

静态二维码内容固定,动态二维码通过短链服务实现内容更新。流程:
1. 用户生成短链:https://q.xservx.com/abc123
2. 后端将短链映射至目标URL(如https://www.xservx.com)
3. 扫码时服务端重定向至最新URL

优势:
• 更新目标内容无需重印二维码
• 支持扫码统计(访问量、地域、时间)
• 可设置有效期、访问权限

5.2 Spring Boot集成方案

整合Redis实现短链管理:

@Service
public class ShortUrlService {
    @Autowired
    private RedisTemplate redisTemplate;
    public String generateShortUrl(String longUrl) {
        String shortKey = UUID.randomUUID().toString().substring(0, 8);
        redisTemplate.opsForValue().set(shortKey, longUrl, 30, TimeUnit.DAYS);
        return "https://q.xservx.com/" + shortKey;
    }
    @GetMapping("/{shortKey}")
    public void redirect(@PathVariable String shortKey, HttpServletResponse response) throws IOException {
        String longUrl = redisTemplate.opsForValue().get(shortKey);
        if (longUrl != null) {
            response.sendRedirect(longUrl);
        } else {
            response.sendError(404);
        }
    }
}

六、安全风险与合规边界

java制作二维码时需警惕:
• 恶意URL:二维码跳转至钓鱼网站
• XSS注入:内容含JavaScript代码
• 隐私泄露:二维码含敏感信息(身份证、银行卡)

6.1 内容安全过滤

生成前对文本进行安全校验:

  • URL白名单校验(仅允许https://q.xservx.com/*)
  • 禁止script、javascript:等危险协议
  • 敏感词过滤(银行卡号、身份证号正则匹配)

6.2 法律合规要点

根据《网络安全法》《个人信息保护法》:
• 生成含个人身份信息的二维码需用户授权
• 二维码跳转页面需符合《互联网信息服务管理办法》
• 商业用途需取得内容版权许可

八、网友最关心的10个问题

java制作二维码常被问及的问题汇总:

1. 如何生成带Logo的二维码?

参考「3.2 带Logo嵌入」部分代码,注意:
• Logo需为PNG透明背景
• 确保纠错等级≥Q
• Logo尺寸≤二维码20%面积

2. 二维码扫不出来怎么办?

排查步骤:
① 检查纠错等级(推荐M或Q)
② 确保白边≥4模块
③ 验证内容无非法字符
④ 扫码设备对焦距离适中

3. 支持中文内容吗?

支持!但需指定编码:
hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
ZXing默认使用ISO-8859-1,不指定将导致中文乱码。

4. 如何生成圆形二维码?

ZXing仅支持矩形模块,需后处理:遍历BitMatrix,将非空模块绘制为圆形(参考「4. 形状定制」)。

5. 动态二维码如何实现?

通过短链服务实现:
1. 生成短链(如q.xservx.com/abc)
2. 服务端存储短链→目标URL映射
3. 扫码时重定向至最新URL

6. 商用需授权吗?

ZXing采用Apache License 2.0,商用免费但需保留版权说明;QRGen同理。OnBarcode免费版有水印,商用需购买授权。

7. 如何优化生成速度?

关键优化点:
• 避免重复创建QRCodeWriter
• 使用线程池并发生成
• 对固定内容启用缓存(如Redis)
• 降低分辨率(如200x200)

8. 支持SVG格式吗?

ZXing不直接支持SVG,但可通过:
• 先生成PNG再转SVG(质量损失)
• 使用第三方库(如qrcode-svg)
• 手动解析BitMatrix生成SVG路径

9. 如何添加渐变色?

ZXing仅支持纯色,需后处理:
1. 生成基础二维码
2. 使用GradientPaint填充Graphics2D画笔
3. 遍历模块绘制渐变圆形

10. 微信扫码提示风险?

微信安全策略:
• 未备案域名跳转会被拦截
• 新生成短链需观察期(12-48小时)
• 内容含违规关键词触发风控
建议:使用备案域名 + 内容合规审查 + 逐步增加访问量