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_CORRECTION | HintType.ERROR_CORRECTION | 纠错等级 | ErrorCorrectionLevel.M |
| CHARACTER_SET | String | 编码字符集 | "UTF-8" |
| MARGIN | Integer | 白边边距(模块数) | 4 |
| WIDTH / HEIGHT | Integer | 图像尺寸(像素) | 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原生不支持圆角,但可通过后处理实现:
- 生成基础二维码BitMatrix
- 遍历非白边区域,将矩形模块替换为圆形路径
- 使用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);
}
}
}
Logo嵌入:高兼容性方案
为避免Logo导致二维码失效,需遵循:
• 使用高纠错等级(Q或H)
• Logo区域留出20%白边
• Logo尺寸≤二维码尺寸的20%
进阶方案:
• 在Logo区域保留部分二维码模块(通过BitMatrix操作)
• 使用半透明Logo(alpha通道=0.7)
• 添加Logo阴影增强层次感
五、动态二维码与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 法律合规要点
根据《网络安全法》《个人信息保护法》:
• 生成含个人身份信息的二维码需用户授权
• 二维码跳转页面需符合《互联网信息服务管理办法》
• 商业用途需取得内容版权许可
七、行业趋势与技术演进
AI增强解码
BoofCV等库引入深度学习模型,提升模糊、低光照场景下的解码成功率。
WebAssembly集成
ZXing WASM版本发布,浏览器端二维码生成/解码性能提升5倍。
AR二维码融合
二维码作为AR触发点,扫码后直接激活3D模型或交互界面。
八、网友最关心的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小时)
• 内容含违规关键词触发风控
建议:使用备案域名 + 内容合规审查 + 逐步增加访问量