使用Barcode4j库在Java Swing中生成可识别GS1-128条码遇阻

你的代码存在几个核心问题，导致生成的GS1-128条码无法被扫描，逐一拆解：

1. 输入字符串格式错误 #

GS1-128条码中，应用标识符（AI，比如01、15这些）不能用括号()包裹，括号只是人类可读的标注，条码实际需要用**FNC1控制字符（ASCII值29）**来分隔不同的AI段。直接传入带括号的字符串会被当成普通字符编码，扫描器无法识别GS1规则。

正确的输入格式应该是：FNC1018638634367382FNC115230316FNC13103000998FNC11045456465604，其中FNC1用(char)29表示。

2. 错误使用普通Code128Bean #

Barcode4j提供了专门的GS1Code128Bean来处理GS1-128条码，它会自动处理FNC1插入、AI校验和编码集切换，而普通的Code128Bean不支持GS1的特殊规则，生成的条码不符合标准。

3. 手动强制设置编码集（Codeset） #

GS1-128会根据AI的内容自动切换编码集（比如数字段用Code C，混合字符用Code B），你手动判断并强制设置Codeset的逻辑会破坏自动编码规则，导致条码结构错误。

4. 关闭了安静区（Quiet Zone） #

条码扫描器需要条码前后的空白安静区来识别起始/结束标记，barcode.doQuietZone(false)会移除这个区域，直接导致扫描失败，必须保留默认的安静区设置。

5. Base64展示问题 #

如果解码后无法展示图片，大概率是你没有给Base64字符串加上图片前缀data:image/png;base64,，前端或图片查看器无法识别这是PNG图片数据。

修正后的代码 #

import org.krysalis.barcode4j.impl.gs1.GS1Code128Bean;
import org.krysalis.barcode4j.output.bitmap.BitmapCanvasProvider;
import javax.imageio.ImageIO;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.Base64;

public class GS1BarcodeGenerator {

    public static String generateGS1Barcode(String humanReadableInput) throws IOException {
        // 第一步：将人类可读的带括号AI转换为GS1标准格式（替换括号为FNC1）
        String gs1Input = convertHumanReadableToGS1(humanReadableInput);

        // 使用GS1专用的条码Bean
        GS1Code128Bean barcode = new GS1Code128Bean();
        final int dpi = 300; // 标准条码DPI，400也可以，但300足够

        // 配置条码参数（保留安静区，不要手动设置编码集）
        barcode.setModuleWidth(0.2); // 保持原设置，可根据需求调整

        // 生成条码位图
        BitmapCanvasProvider canvas = new BitmapCanvasProvider(
                dpi,
                java.awt.image.BufferedImage.TYPE_BYTE_BINARY,
                false,
                0 // 安静区默认值，不要修改为0以外的数值
        );
        barcode.generateBarcode(canvas, gs1Input);
        canvas.finish();

        // 转换为Base64字符串，加上图片前缀
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        ImageIO.write(canvas.getBufferedImage(), "png", outputStream);
        byte[] barcodeBytes = outputStream.toByteArray();
        return "data:image/png;base64," + Base64.getEncoder().encodeToString(barcodeBytes);
    }

    // 辅助方法：将(01)XXX(15)XXX格式转换为GS1标准格式（插入FNC1）
    private static String convertHumanReadableToGS1(String input) {
        // 替换所有(AI)为FNC1+AI
        return input.replaceAll("\\((\\d+)\\)", (char)29 + "$1");
    }

    public static void main(String[] args) throws IOException {
        String humanInput = "(01)8638634367382(15)230316(3103)000998(10)45456465604";
        String base64Barcode = generateGS1Barcode(humanInput);
        System.out.println(base64Barcode);
    }
}

关键注意事项 #

• 确保你的Barcode4j依赖包含barcode4j-fop或完整的barcode4j包，因为GS1Code128Bean在扩展模块中。
• 测试时用专业的GS1条码扫描器或支持GS1规则的APP（比如微信扫码、支付宝扫码都支持GS1-128）。
• 不要随意修改条码的模块宽度、安静区等参数，保持符合GS1标准的配置。

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