TCP Socket写入Protobuf消息异常求助：仅特定代码生效且跨平台失效

一、两种写法失效的原因 #

1. 直接写入getSerializedSize()的问题 #

OutputStream.write(int)方法只会写入参数的低8位二进制数据（即把int当作单个字节处理）。但Protobuf消息的序列化大小通常远大于255（0xFF），服务端收到的长度值完全错误，自然无法正确读取后续消息体，导致解析失败。

2. 直接写入toByteArray()的问题 #

TCP是流式传输协议，没有天然的消息边界。只写入消息体的话，服务端无法判断一条消息的结束位置，会出现粘包/拆包问题（比如多条消息被合并读取，或者一条消息被拆分），导致Protobuf解析器无法识别完整的消息结构。

二、Android<->iOS跨平台失效的核心原因 #

你当前的有效代码用intToByte()把长度转成了**大端字节序（Big-Endian）的4字节数据，但iOS端大概率是按照小端字节序（Little-Endian）**来解析这个长度字段的，导致iOS侧读取到的长度值完全错误，无法读取对应长度的消息体，最终解析失败。

另外需要注意：Android和iOS使用的Protobuf版本、.proto schema定义必须完全一致（包括字段编号、类型、是否必填等），否则也会出现跨平台解析失败的情况。

三、解决方案 #

方案1：使用Protobuf官方推荐的Varint长度前缀（最优） #

Protobuf官方推荐用Varint编码传递消息长度，它是一种可变长度的编码方式，既节省空间，又天然具备跨平台兼容性（Protobuf内部编码全基于Varint）。

Android端写入代码：

OutputStream outputStream = mClientSSLSocket.getOutputStream();
CodedOutputStream codedOut = CodedOutputStream.newInstance(outputStream);
// 写入Varint编码的消息长度
codedOut.writeUInt32NoTag(message.getSerializedSize());
// 写入消息体
message.writeTo(codedOut);
// 刷新确保数据发送
codedOut.flush();

iOS端读取代码示例（Swift）：

let inputStream = sslSocket.inputStream!
inputStream.open()

// 读取Varint编码的长度
var length: UInt32 = 0
var shift = 0
var currentByte: UInt8 = 0
var readSuccess = true

repeat {
    var buffer = [UInt8](repeating: 0, count: 1)
    let bytesRead = inputStream.read(&buffer, maxLength: 1)
    if bytesRead <= 0 {
        readSuccess = false
        break
    }
    currentByte = buffer[0]
    length |= UInt32(currentByte & 0x7F) << shift
    shift += 7
} while (currentByte & 0x80) != 0

guard readSuccess else {
    // 处理连接异常
    return
}

// 读取对应长度的消息体
var messageBuffer = [UInt8](repeating: 0, count: Int(length))
let bytesRead = inputStream.read(&messageBuffer, maxLength: Int(length))
if bytesRead == Int(length) {
    if let message = try? YourProtobufMessage(serializedData: Data(messageBuffer)) {
        // 处理解析后的消息
    }
}

方案2：统一使用固定字节序的4字节长度（兼容现有逻辑） #

如果要保留4字节长度的逻辑，必须确保Android和iOS两端都使用相同的字节序（推荐用大端，符合网络传输通用规范）。

Android端保持现有长度写入逻辑不变，iOS端按大端解析长度的Swift代码：

let inputStream = sslSocket.inputStream!
inputStream.open()

// 读取4字节大端长度
var lengthBuffer = [UInt8](repeating: 0, count: 4)
let bytesRead = inputStream.read(&lengthBuffer, maxLength: 4)
if bytesRead != 4 {
    // 处理长度读取失败
    return
}

// 大端字节序转UInt32
let length = UInt32(lengthBuffer[0]) << 24 | 
             UInt32(lengthBuffer[1]) << 16 | 
             UInt32(lengthBuffer[2]) << 8 | 
             UInt32(lengthBuffer[3])

// 后续读取消息体逻辑同方案1

额外注意事项 #

• 确保Android和iOS使用的Protobuf版本一致，且.proto文件完全相同（字段编号、类型、修饰符不能有差异）。
• 网络传输时要处理IO异常（比如连接断开、读取超时等），避免因异常导致的解析失败。

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