Java与C#跨语言Base64编解码适配问题咨询（有/无符号字节）

在Java中创建长度为8、元素均为Byte.MIN_VALUE的字节数组，代码如下：

byte[] bytes = new byte[8];
Arrays.fill(bytes, Byte.MIN_VALUE);
// 注：Byte.MIN_VALUE实际值为-128，此处标注的[-127,...]为笔误
String base64string = Base64.getEncoder().encodeToString(bytes);

编码后得到Base64字符串：gICAgICAgIA=。但通过C#解码该字符串后，得到的数组是[128, 128, 128, 128, 128, 128, 128, 128]，与预期的[0, 0, 0, 0, 0, 0, 0, 0]不符，核心原因是C#的byte是无符号类型（0_{255），而Java的`byte`是有符号类型（-128}127），二者对同一二进制位序列的数值解读不同。

反之，C#中创建元素为byte.MinValue（即0）的字节数组，编码得到Base64字符串AAAAAAAAAAA=，Java解码后得到[0, 0, 0, 0, 0, 0, 0, 0]，而非预期的[-128, -128, -128, -128, -128, -128, -128, -128]，同样是因为字节的符号解读差异。

解决方案 #

1. Java端：将有符号byte转为无符号表示后编码Base64 #

若要让C#解码后得到与Java原数值对应的无符号byte，可在Java中先将有符号byte转换为无符号二进制表示（保留0~255的数值范围），再进行Base64编码：

import java.util.Arrays;
import java.util.Base64;

public class ByteEncoding {
    public static void main(String[] args) {
        byte[] signedBytes = new byte[8];
        Arrays.fill(signedBytes, Byte.MIN_VALUE);
        
        // 将有符号byte转为无符号二进制表示
        byte[] unsignedBytes = new byte[signedBytes.length];
        for (int i = 0; i < signedBytes.length; i++) {
            // 通过与0xFF按位与，保留无符号的8位二进制值
            unsignedBytes[i] = (byte) (signedBytes[i] & 0xFF);
        }
        
        String base64 = Base64.getEncoder().encodeToString(unsignedBytes);
        // 此时C#解码该Base64后，得到的byte数组数值为[128, 128, ...]，对应Java原Byte.MIN_VALUE的无符号映射值
        // 若你需要C#得到[0,0,...]，直接构造全0字节数组编码即可
    }
}

2. C#端：解码后转换为有符号数值适配Java #

如果Java直接编码有符号byte的二进制，C#解码后可将无符号byte转换为Java风格的有符号数值：

using System;

class ByteDecoding {
    static void Main() {
        string base64FromJava = "gICAgICAgIA=";
        byte[] unsignedBytes = Convert.FromBase64String(base64FromJava);
        
        // 将无符号byte转为Java兼容的有符号sbyte
        sbyte[] signedBytes = Array.ConvertAll(unsignedBytes, b => (sbyte)b);
        // 此时signedBytes结果为[-128, -128, ...]，与Java原数组一致
        
        // 若你期望得到[0,0,...]，可手动映射数值：
        byte[] expectedBytes = Array.ConvertAll(unsignedBytes, b => b == 128 ? (byte)0 : b);
    }
}

3. 双向兼容的统一规则 #

要实现Java与C#互相编码解码都能得到预期结果，需统一数值映射规则：

• 规则1：二进制位一致，数值按符号类型转换
  • Java编码：先将每个有符号byte转为无符号表示（b & 0xFF后转byte）再编码。
  • C#解码：直接使用byte数组，或转为sbyte得到Java原数值。
  • C#编码：直接编码byte数组，Java解码后将每个byte转为有符号数值（(sbyte)b）。
• 规则2：强制数值映射（如Java Byte.MIN_VALUE对应C# byte.MinValue）
  • 若要求Java的Byte.MIN_VALUE对应C#的0，则双方直接编码全0字节数组；若需要反向映射，解码后手动将0转换为Byte.MIN_VALUE即可。

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