Java从ZIP字符串生成Data Matrix遇ISO-8859-1编码超出错误如何解决

你当前的代码存在两处核心问题导致异常抛出：

• 错误将二进制ZIP字节数组用UTF-8编码转字符串：ZIP是二进制格式，字节取值范围为0-255，大量字节不符合UTF-8编码规则，转码过程会出现乱码、字节丢失，生成超出ISO-8859-1范围的非法字符。
• 未指定Zxing编码参数：默认情况下Zxing的DataMatrixWriter会校验输入字符是否属于ISO-8859-1范围，非法字符直接触发IllegalArgumentException。

以下提供两种落地性强的实现方案，可根据业务场景选择：

方案1：直接二进制编码（信息密度最高） #

利用ISO-8859-1单字节编码的特性，每个字节都对应唯一有效字符，不会出现转码丢失，无需额外转换即可直接编码，条码存储密度最高。

生成代码 #

import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.datamatrix.DataMatrixWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;

// 原有逻辑获取ZIP字节数组
byte[] bytesOfZIP= (byte[])statD.returnObj;
// 用ISO-8859-1转字符串，保证所有字节完整保留
String texto = new String(bytesOfZIP, StandardCharsets.ISO_8859_1);
DataMatrixWriter barcodeWriter = new DataMatrixWriter();
// 配置编码参数，指定字符集为ISO-8859-1
Map<EncodeHintType, Object> hints = new HashMap<>();
hints.put(EncodeHintType.CHARACTER_SET, "ISO-8859_1");
// 传入参数生成条码
BitMatrix bitMatrix = barcodeWriter.encode(texto, BarcodeFormat.DATA_MATRIX, 400, 400, hints);
BufferedImage bi = MatrixToImageWriter.toBufferedImage(bitMatrix);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 采用PNG无损格式存储，避免JPG有损压缩导致识别失败
ImageIO.write(bi, "png", baos);
byte[] fbytes = baos.toByteArray();

扫码解码逻辑 #

// 扫码得到的字符串内容scanResult
byte[] originalZipBytes = scanResult.getBytes(StandardCharsets.ISO_8859_1);
// 直接写入文件即可得到原始ZIP文件

方案2：Base64转码（兼容性最强） #

如果需要对接多端扫码场景，担心不同扫码工具对二进制编码的Data Matrix支持不足，可以先将ZIP字节数组转成Base64编码字符串，Base64全部为可打印ASCII字符，完全不存在编码兼容问题。

生成代码 #

import java.util.Base64;
import com.google.zxing.BarcodeFormat;
import com.google.zxing.datamatrix.DataMatrixWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;

byte[] bytesOfZIP= (byte[])statD.returnObj;
// 转Base64字符串，全为可打印字符，无编码异常
String base64Content = Base64.getEncoder().encodeToString(bytesOfZIP);
DataMatrixWriter barcodeWriter = new DataMatrixWriter();
BitMatrix bitMatrix = barcodeWriter.encode(base64Content, BarcodeFormat.DATA_MATRIX, 400, 400);
BufferedImage bi = MatrixToImageWriter.toBufferedImage(bitMatrix);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
ImageIO.write(bi, "png", baos);
byte[] fbytes = baos.toByteArray();

扫码解码逻辑 #

// 扫码得到的Base64字符串scanResult
byte[] originalZipBytes = Base64.getDecoder().decode(scanResult);

• Data Matrix有存储容量上限，若ZIP内容过大超出单码容量，需要拆分内容生成多个条码，或降低ZIP压缩率缩小体积。
• 禁止使用JPG格式存储条码，JPG的有损压缩会导致条码边缘模糊，大幅提升识别失败概率。

内容的提问来源于stack exchange，提问作者Victorqedu