Java案例怎么生成二维码图片？

wen java案例 2026-06-10 12

Java案例怎么生成二维码图片？——完整实战指南

📖 目录导读

为什么要使用Java生成二维码？
核心依赖与工具选择
环境搭建与Maven配置
基础案例：Java生成二维码图片（含代码）
进阶案例：带Logo、颜色、背景的二维码
常见错误与排错指南
常见问题问答（FAQ）
总结与SEO优化建议

为什么要使用Java生成二维码？

在现代企业应用中,二维码被广泛用于支付、登录验证、活动导流、物料追踪等场景，Java作为后端开发的主流语言，能够在服务端动态生成二维码图片，并通过API或文件流交付给前端或客户端。

Java案例怎么生成二维码图片？

核心优势：

跨平台：Java生成的二维码图片（如PNG/JPEG）可在任何设备上识别。
可扩展：支持自定义颜色、图标、纠错级别、尺寸。
性能稳定：成熟第三方库（如ZXing）经过长期维护，支持批量生成。

核心依赖与工具选择

目前Java生态中生成二维码的主流库是 ZXing（Zebra Crossing）和 qrcode。
本文选用 ZXing，因为它：

开源、文档丰富
支持多种图片格式（PNG/JPEG/GIF）
可调整纠错级别（L/M/Q/H）

备选方案：

qrcode：轻量级，适合简单场景
Google ZXing Core：生产级推荐

环境搭建与Maven配置

在pom.xml中添加ZXing核心库和图片库：

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

确保JDK版本8+，IDE推荐IntelliJ IDEA。

基础案例：Java生成二维码图片（含代码）

步骤说明

定义二维码内容（如URL、文本）
设置二维码参数（尺寸、编码、纠错级别）
使用QRCodeWriter生成矩阵
转化为BufferedImage并输出为PNG图片

完整代码示例

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.WriterException;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.QRCodeWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.HashMap;
import java.util.Map;
public class QRCodeGenerator {
    public static void main(String[] args) {
        String content = "https://www.example.com"; // 二维码内容
        int width = 300;
        int height = 300;
        String filePath = "qrcode.png";
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        hints.put(EncodeHintType.ERROR_CORRECTION, com.google.zxing.qrcode.decoder.ErrorCorrectionLevel.H);
        hints.put(EncodeHintType.MARGIN, 1); // 边距
        try {
            QRCodeWriter qrCodeWriter = new QRCodeWriter();
            BitMatrix bitMatrix = qrCodeWriter.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
            Path path = Paths.get(filePath);
            MatrixToImageWriter.writeToPath(bitMatrix, "PNG", path);
            System.out.println("二维码已生成：" + filePath);
            // 如果你需要返回BufferedImage用于内存操作
            BufferedImage image = MatrixToImageWriter.toBufferedImage(bitMatrix);
            ImageIO.write(image, "PNG", new File(filePath));
        } catch (WriterException | IOException e) {
            e.printStackTrace();
        }
    }
}

运行结果：在项目根目录生成qrcode.png，扫描后跳转到指定网址。

进阶案例：带Logo、颜色、背景的二维码

功能点

自定义前景色、背景色
在中心嵌入Logo（小图片）
调整纠错级别以容纳Logo

代码核心逻辑

public static BufferedImage createColorQR(String content, int width, int height, Color foreground, Color background, File logoFile) {
    Map<EncodeHintType, Object> hints = new HashMap<>();
    hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
    hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H); // 高纠错以容纳Logo
    QRCodeWriter writer = new QRCodeWriter();
    BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
    // 创建自定义颜色图片
    BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
    for (int x = 0; x < width; x++) {
        for (int y = 0; y < height; y++) {
            image.setRGB(x, y, matrix.get(x, y) ? foreground.getRGB() : background.getRGB());
        }
    }
    // 嵌入Logo（放缩到适当大小）
    if (logoFile != null && logoFile.exists()) {
        BufferedImage logo = ImageIO.read(logoFile);
        int logoSize = width / 5; // Logo占二维码1/5
        int x = (width - logoSize) / 2;
        int y = (height - logoSize) / 2;
        Graphics2D g = image.createGraphics();
        g.drawImage(logo.getScaledInstance(logoSize, logoSize, Image.SCALE_SMOOTH), x, y, null);
        g.dispose();
    }
    return image;
}

调用示例：

BufferedImage qr = createColorQR("https://example.com", 400, 400, Color.BLACK, Color.WHITE, new File("logo.png"));
ImageIO.write(qr, "PNG", new File("advanced_qr.png"));

常见错误与排错指南

| 错误现象 | 可能原因 | 解决方案 | |---------|---------|---------|过长无法生成 | 数据超过版本容量 | 使用更高纠错级别H，或缩短内容 | | 中文乱码 | 未设置UTF-8编码 | 添加 hints.put(EncodeHintType.CHARACTER_SET, "UTF-8") | | 生成的二维码无法被识别 | 纠错级别太低或图片模糊 | 使用 ErrorCorrectionLevel.H，提升图片DPI | | 内存溢出（批量生成时） | 未释放BufferedImage | 使用完dispose()，或采用文件流逐步写入 |