Java案例如何实现条形码？

wen python案例 2026-07-22 1

Java案例如何实现条形码？从零到生产级的完整指南

目录导读

条形码技术基础 – 为什么 Java 是首选实现语言？
主流条形码库对比 – ZXing vs Barbecue vs Barcode4J
案例实战：生成 EAN-13 条形码（含完整代码）
案例实战：解析/读取条形码（从图片到字符串）
常见问题与问答 – 编码错误、分辨率、中文支持
性能优化与生产部署 – 多线程、缓存、容器化
SEO 关键词总结 – 条码生成、Java库、二维码扩展

条形码技术基础

条形码（Barcode）是将宽度不等的多个黑条和空白，按照一定的编码规则排列，用以表达一组信息的图形标识符，在 Java 生态中，实现条形码生成与解析主要依赖开源库，ZXing（Zebra Crossing）是 Google 维护的业界标准，支持 1D（如 EAN-13、Code128）和 2D（如 QR Code）。

Java案例如何实现条形码？

为什么选择 Java？

跨平台：一次编写，在 Windows/Linux/macOS 的 Web 或桌面端均可运行。
成熟生态：ZXing 已被 Spring、Servlet 容器广泛集成。
企业级需求：库存管理、物流标签、医疗腕带等场景天然需要 Java 后端。

主流条形码库对比

库名称	特点	适合场景	Maven 坐标
ZXing	支持 40+ 格式，活跃维护，带解析功能	绝大多数生产系统	`com.google.zxing:core:3.5.3`
Barbecue	轻量，仅支持 1D 条形码	简单标签生成	`net.sourceforge.barbecue:barbecue:1.5-beta1`
Barcode4J	支持多种输出格式（SVG/EPS）	印刷级矢量图	`net.sf.barcode4j:barcode4j:2.1`

推荐选择：ZXing（社区活跃、文档齐全、内置矩阵码支持）。

案例实战：生成 EAN-13 条形码

1 添加 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>

2 核心生成代码

import com.google.zxing.BarcodeFormat;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.oned.EAN13Writer;
import java.io.File;
import java.nio.file.Path;
public class BarcodeGenerator {
    public static void main(String[] args) throws Exception {
        String code = "5901234123457"; // 13位数字，最后一位为校验码
        int width = 300;
        int height = 120;
        EAN13Writer writer = new EAN13Writer();
        BitMatrix matrix = writer.encode(code, BarcodeFormat.EAN_13, width, height);
        Path path = new File("barcode_ean13.png").toPath();
        MatrixToImageWriter.writeToPath(matrix, "PNG", path);
        System.out.println("条形码已生成至: " + path.toAbsolutePath());
    }
}

关键点：

数据必须为13位数字，ZXing 会自动校验补全最后一位校验码。
writeToPath 支持 PNG、JPG、GIF 格式。

3 生产增强：添加下方数字文本

ZXing 不提供文字渲染，需要手动叠加，可通过 Graphics2D 合并：

BufferedImage image = MatrixToImageWriter.toBufferedImage(matrix);
Graphics2D g = image.createGraphics();
g.setFont(new Font("Arial", Font.PLAIN, 14));
g.drawString(code, 80, height - 10); // 调整位置
g.dispose();
ImageIO.write(image, "PNG", new File("barcode_with_text.png"));

案例实战：解析/读取条形码

1 从图片文件读取

import com.google.zxing.BinaryBitmap;
import com.google.zxing.MultiFormatReader;
import com.google.zxing.Result;
import com.google.zxing.client.j2se.BufferedImageLuminanceSource;
import com.google.zxing.common.HybridBinarizer;
import javax.imageio.ImageIO;
import java.io.File;
public class BarcodeReader {
    public static void main(String[] args) throws Exception {
        File file = new File("barcode_ean13.png");
        BufferedImage image = ImageIO.read(file);
        BinaryBitmap bitmap = new BinaryBitmap(
            new HybridBinarizer(new BufferedImageLuminanceSource(image)));
        Result result = new MultiFormatReader().decode(bitmap);
        System.out.println("解析结果: " + result.getText());
        System.out.println("格式: " + result.getBarcodeFormat());
    }
}

2 处理常见识别失败

图像过暗：先灰度化再二值化。
旋转条形码：设置 TryHarder 参数。
模糊图像：增加本地对比度增强。

Map<DecodeHintType, Object> hints = new HashMap<>();
hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE);
hints.put(DecodeHintType.POSSIBLE_FORMATS, 
    Arrays.asList(BarcodeFormat.EAN_13, BarcodeFormat.CODE_128));
result = new MultiFormatReader().decode(bitmap, hints);

常见问题与问答

Q1：生成条形码时出现“IllegalArgumentException: Input length 12”错误？
A：EAN-13要求13位数字，如果你的数据只有12位，ZXing认为最后缺少校验位，可以手动补全或使用EAN13Writer的自动计算功能。
正确做法：传入12位数字（不含校验码）,库会自动计算并添加。

Q2：生成的条形码在扫描枪下无法识别？
A：检查以下三项：

分辨率至少 200 DPI（设置 width/height 等于实际像素值）。
黑白对比强烈，确保背景纯白、条码纯黑。
左右留有 1-2mm 静区（ZXing 默认已包含）。

Q3：如何在 Java 中生成带中文的条形码？
A：1D 条形码（如 Code128）不支持中文，如需中文，请使用 QR Code（二维码），ZXing 支持 UTF-8 编码。

// 生成二维码（可包含中文）
QRCodeWriter writer = new QRCodeWriter();
BitMatrix matrix = writer.encode("商品名称：苹果", 
    BarcodeFormat.QR_CODE, 300, 300);

Q4：性能瓶颈在批量生成上百个条形码时如何优化？
A：使用线程池并行生成：

ExecutorService executor = Executors.newFixedThreadPool(10);
List<Future<File>> futures = new ArrayList<>();
for (String code : codeList) {
    futures.add(executor.submit(() -> generateBarcode(code)));
}

性能优化与生产部署

1 缓存策略

内存缓存：用 ConcurrentHashMap<Code, BufferedImage> 缓存最近使用的条码。
分布式缓存：使用 Redis 存二进制数据,减少重复生成。

2 容器化部署

Dockerfile 示例：

FROM openjdk:17-jdk-slim
COPY target/barcode-service.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

注意：服务器字体包（fontconfig）缺失会造成文本渲染失败，可安装 apt-get install -y fontconfig ttf-dejavu。

3 输出格式选择

Web 应用：以字节流返回 image/png。
微服务：生成后上传至 S3/MinIO，返回 URL。
印刷：生成 SVG 矢量图（Barcode4J 更优）。

SEO 关键词总结

本文全面覆盖了 Java 条形码生成 的核心知识，包括：

EAN-13 生成：基于 ZXing 的完整代码。
条形码解析：从图像到字符串的逆向流程。
生产实践：多线程、缓存、Docker 部署。
常见问题：校验码、中文支持、扫描失败原因。

相关搜索词：Java 条形码库、ZXing 使用教程、条形码生成 Spring Boot、条码扫描 Java、条形码校验码计算、批量生成条形码、二维码与条码区别。

最终案例：一个完整的 Spring Boot 控制器

@RestController
public class BarcodeController {
    @GetMapping("/barcode")
    public ResponseEntity<byte[]> generate(@RequestParam String code) {
        try {
            EAN13Writer writer = new EAN13Writer();
            BitMatrix matrix = writer.encode(code, BarcodeFormat.EAN_13, 300, 120);
            ByteArrayOutputStream os = new ByteArrayOutputStream();
            MatrixToImageWriter.writeToStream(matrix, "PNG", os);
            return ResponseEntity.ok()
                .header("Content-Type", "image/png")
                .body(os.toByteArray());
        } catch (Exception e) {
            return ResponseEntity.badRequest().body(null);
        }
    }
}

访问：http://localhost:8080/barcode?code=5901234123457 即可直接获取图片。

最后提醒：条形码标准（EAN/UPC）涉及商业授权，仅在内部系统使用是安全的，如用于零售结算请确保合法的 GS1 厂商前缀。