Java中含负字节的热敏打印机命令数组转字符串的问题

问题根源 #

这确实是String类的编码特性导致的问题：Java的String基于Unicode，使用无参new String(byte[])构造方法时，会用JVM默认编码（通常是UTF-8）解析字节。0xF0属于UTF-8 4字节编码的起始字节，单独存在时是无效的UTF-8序列，会被替换成Unicode替换字符U+FFFD，再调用getBytes()就会输出该字符对应的UTF-8字节序列0xEF 0xBF 0xBD（即你看到的-17、-65、-67），完全偏离了原命令字节。

解决方案 #

因为JNA接口要求传入String，核心思路是用单字节编码映射字节与字符，确保转换过程完全无损：

方案1：使用ISO-8859-1编码（推荐） #

ISO-8859-1是单字节编码，0x00-0xFF范围内的每个字节都对应唯一的Unicode字符，转换时不会丢失任何信息：

// 构造切纸命令字节数组
byte[] cutCommand = {0x1B, (byte)0xF0, 0x06, 0x01, 0x01};
// 用ISO-8859-1编码转换为String
String cutString = new String(cutCommand, StandardCharsets.ISO_8859_1);
// 调用JNA方法，size参数直接使用原字节数组的长度
exo_api_printer_write(printer, cutString, cutCommand.length, timeout_ms);

• 注意：size参数必须用原字节数组的长度，不能用cutString.length()（虽然单字节编码下两者数值相同，但直接使用原数组长度更稳妥）。

方案2：修改JNA接口定义（若可行） #

如果有权限修改JNA接口，直接让方法接受byte[]类型参数，从根源上避免String转换的编码问题：

// 修改后的JNA接口方法
int exo_api_printer_write(Pointer printer, byte[] data, int size, long timeout_ms);

• 直接传入原字节数组，完全不会有编码异常，是最可靠的方案，但需要确认厂商是否提供了对应的重载方法，或者你有权限修改接口定义。

方案3：手动构造兼容String（不推荐） #

如果只能使用JVM默认编码，可以手动将0xF0替换为对应编码中能正确映射的字符，但这种方法依赖JVM默认编码的特性，兼容性极差，不建议使用。

关键注意事项 #

• 所有打印机控制命令的转换都要统一使用单字节编码（比如ISO-8859-1），不能混用无参构造的默认编码，否则会出现部分命令正常、部分失效的情况。
• 调用JNA方法时的size参数必须严格对应原命令的字节数，不能依赖String的长度。

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